---
sidebar_label: "阅读模式实战"
title: "阅读模式 - CyberGo html | LLM 纯净页面提取"
description: "CyberGo html 阅读模式：用 ReadPage 把整页切成 header/navigation/main/aside/footer 分区并保留内联链接，直接输出可喂给 LLM 的 Markdown；含 ReadResult 结构、Render 与 RenderText 差异及与 Extract 的取舍。"
sidebar_position: 15
---
# 阅读模式
阅读模式（`ReadPage` 系列）把整页按结构分区保留，而不是只选出一篇文章。它面向把网页内容喂给 LLM、RAG 或文本分析管线的场景：HTML/CSS/JS 标记被移除，导航与页脚仍在，但被标注为独立分区，内联超链接保留为 `[文字](URL)`。
## 与 Extract 的区别
| 维度 | `Extract` | `ReadPage` |
|------|-----------|-----------|
| 输出 | 选中的正文 + 元数据 | 整页分区（`[]PageSection`） |
| 导航、页脚 | 移除 | 保留并标注类别 |
| 广告、相关推荐 | 移除 | 移除 |
| 内联链接 | 由 `InlineLinkFormat` 决定，默认不输出 | 始终保留 |
| 结果类型 | `Result` | `ReadResult` |
| 缓存 | 参与 | 不参与（结果类型不同） |
需要「只要正文」时用 `Extract`；需要「整页可读文本 + 结构标签」时用 `ReadPage`。
## 一次调用输出整页
两个最常用的入口直接返回一个 Markdown 文档：
```go
package main
import (
"fmt"
"log"
"github.com/cybergodev/html"
)
func main() {
page := []byte(`
季度业绩公告
季度业绩公布
公司周二公布了强劲的季度业绩。完整分析另见。
`)
// 带链接：适合需要引用来源的提示词
md, err := html.ReadPageToMarkdown(page)
if err != nil {
log.Fatal(err)
}
fmt.Println(md)
// 不带链接：链接文字保留为普通词
plain, err := html.ReadPageToMarkdownText(page)
if err != nil {
log.Fatal(err)
}
fmt.Println(plain)
}
```
`ReadPageToMarkdown` 输出（节选）：
```text
# 季度业绩公告
# Header
[首页](/) [科技](/tech)
# Main Content
# 季度业绩公布
公司周二公布了强劲的季度业绩。[完整分析](/analysis) 另见。
# Aside
侧栏：市场数据摘要。
# Footer
© 2026 示例新闻
```
`ReadPageToMarkdownText` 输出同结构，但 `[首页](/)` 变为 `首页`。
:::tip 分区标题是英文
`Render`/`RenderText` 的分区标题固定为 `Header` / `Navigation` / `Main Content` / `Aside` / `Footer`，与 `SectionKind` 的取值（`header`/`navigation`/`main`/`aside`/`footer`）一一对应。文档标题（`ReadResult.Title`）在可用时作为最顶层的 `#` 标题。
:::
## 结构化分区
需要自行筛选分区时调用 `ReadPage`：
```go
page, err := html.ReadPage(htmlBytes)
if err != nil {
log.Fatal(err)
}
for _, sec := range page.Sections {
fmt.Println(sec.Kind, sec.WordCount)
}
```
`ReadResult` 与 `PageSection` 的逐字段说明见 [API 参考：ReadResult](../../api-reference/core/reader#readresult) 与 [PageSection](../../api-reference/core/reader#pagesection)。
`SectionKind` 的取值与判定依据：
| 常量 | 值 | 判定依据 |
|------|-----|----------|
| `SectionHeader` | `header` | ``、`role=banner`，或 class/id 含 `header`/`masthead` |
| `SectionNavigation` | `navigation` | `