> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# SEO（搜索引擎优化）

> 优化 SEO，提升文档的可发现性。

<Tip>
  本页介绍优化文档 SEO 的基础策略。
</Tip>

<div id="content-basics">
  ## 内容基础
</div>

让你的写作与结构便于搜索引擎快速扫描。

* **标题与副标题：** 使用循序且有意义的标题来组织内容。每个页面都有一个由 frontmatter 中的 `title:` 属性生成的 H1。
* **短段落与项目列表：** 将大段文本拆分为易读的部分。在合适的场景使用项目符号和编号列表。
* **内部链接：** 使用具描述性的锚文本链接到相关内容。例如，使用“了解更多关于速率限制”的表述，而不是“点击这里”。

<div id="technical-seo-basics">
  ## 技术 SEO 基础
</div>

在优化好内容后，也要确保文档在技术层面表现良好。

这些基础的技术 SEO（搜索引擎优化）做法有助于提升文档的可发现性：

* **Meta 标签与描述：** 为每个页面撰写有利于 SEO 的标题（50–60 个字符）和描述（150–160 个字符）。大多数[meta 标签](/zh/optimize/seo)会自动生成。
* **图片 Alt 文本：** 为图片提供包含相关关键词的描述性 alt 文本。例如，用 “OAuth 2.0 API 认证流程” 而不是仅写 “diagram”。这有助于提升 SEO 和可访问性。
* **站点地图（Sitemaps）：** 确保站点地图为最新。Mintlify 会自动生成站点地图；如需自定义格式，也可手动创建。创建后，搜索引擎会随着时间索引站点地图，但你也可以将其直接提交到 Google Search Console 以加快收录。

<div id="page-performance">
  ## 页面性能
</div>

使用 [Google PageSpeed Insights](https://pagespeed.web.dev) 等工具识别可改进的技术层面 SEO（搜索引擎优化）机会。

更高级的优化示例：

* **为速度优化媒体：** 使用 WebP 或 AVIF 等格式压缩图片，并确保页面加载迅速（理想情况下不超过 3 秒）。
* **结构化数据（schema 标注）：** 在页面中添加 schema 标注（如 HowTo、FAQ），帮助搜索引擎更好地理解并提升内容的排名。

<div id="keyword-research">
  ## 关键词研究
</div>

为提升自然流量，花时间了解哪些关键词能帮助用户找到你的文档。

* **关键词研究：** 使用免费的工具，例如 [Google Keyword Planner](https://ads.google.com/intl/en_us/home/tools/keyword-planner/) 或 [Keywords Everywhere](https://keywordseverywhere.com)，来识别常见词组或长尾关键词。
* **自然融入关键词：** 将关键词自然地融入标题、副标题以及正文各处。不要刻意堆砌关键词。你的文档应以用户为中心，而非搜索引擎。