- 生成 meta 标签
- 生成站点地图和
robots.txt文件 - 语义化 HTML 结构
- 移动端优化
docs.json 或页面的 frontmatter 中添加 metatags 字段,来自定义站点的 meta 标签。
你可以在 docs.json 中添加 metadata 字段来设置默认的 meta 标签。
docs.json 中的 meta 标签完整列表。这些标签有助于提升站点的 SEO(搜索引擎优化)、社交分享效果和浏览器兼容性。
你可以使用 metatags.io 预览这些 meta 标签在不同平台上的呈现方式。
站点地图与 robots.txt 文件
sitemap.xml 和 robots.txt 文件。你可以在文档站点的 URL 末尾追加 /sitemap.xml 来查看站点地图。
默认情况下,仅 docs.json 中列出的页面会被包含。若要将隐藏链接也纳入其中,请在 docs.json 中添加 seo.indexing:
自定义 sitemap 和 robots.txt 文件
sitemap.xml 或 robots.txt 文件,请在项目根目录创建相应的 sitemap.xml 或 robots.txt 文件。添加自定义文件会覆盖同名的自动生成文件。删除自定义文件后,将恢复使用默认文件。
禁用索引编入
docs.json 中将 metadata.robots 字段设置为 "noindex",为文档中的所有页面指定 noindex:
SEO 最佳实践
撰写具有描述性的标题与说明
撰写具有描述性的标题与说明
- 使用清晰、具有描述性的页面标题(50–60 个字符)
- 撰写具有吸引力的说明(150–160 个字符)
- 包含相关关键词
- 确保每个页面的标题和说明都独一无二
优化内容结构
优化内容结构
- 使用正确的标题层级(H1 → H2 → H3)
- 优先为人而写,其次再考虑搜索引擎
- 在标题和正文中包含相关关键词
- 保持 URL 简洁、具描述性,并按层级组织
- 用小标题和列表拆分长篇内容
内部链接策略
内部链接策略
- 在文档中链接到相关页面
- 使用描述性的锚文本,而非“click here”
- 通过链接相关概念创建主题集群
- 使用自动交叉引用功能
图片 SEO
图片 SEO
- 为图片使用具有描述性的文件名
- 始终为无障碍与 SEO 添加 alt 文本
- 优化图片文件大小以提升加载速度
- 使用与内容相关、能起到支撑作用的图片