SEO（搜索引擎优化）

如何提升文档站点的 SEO

本文介绍优化文档 SEO 的基础策略。

​

内容基础

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

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

​

技术 SEO 基础

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

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

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

​

页面性能

使用 Google PageSpeed Insights 等工具识别可改进的技术层面 SEO（搜索引擎优化）机会。

更高级的优化示例：

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

​

关键词研究

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

• 关键词研究： 使用免费的工具，如 Google 关键词规划师 或 Keywords Everywhere 来识别常见短语或长尾关键词。
• 自然融入关键词： 将关键词自然地放入标题、小标题以及正文各处。不要刻意堆砌关键词。你的文档应以用户为中心，而不是为搜索引擎而写。