mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
f7a35ff818
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
55 lines
3.0 KiB
Plaintext
55 lines
3.0 KiB
Plaintext
---
|
||
title: "SEO（搜索引擎优化）"
|
||
description: "优化搜索引擎优化（SEO），通过元数据和内容策略提升文档的可发现性。"
|
||
keywords: ["search engine optimization", "meta tags", "keyword research"]
|
||
---
|
||
|
||
<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 以加快收录。
|
||
|
||
<Tip>
|
||
使用[工作流](/zh/agent/workflows)执行每周 SEO 审计，检查缺失或薄弱的 metadata，并提交包含改进的拉取请求。
|
||
</Tip>
|
||
|
||
<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)，来识别常见词组或长尾关键词。
|
||
* **自然融入关键词：** 将关键词自然地融入标题、副标题以及正文各处。不要刻意堆砌关键词。你的文档应以用户为中心，而非搜索引擎。 |