mintlify__docs/zh/guides/index.mdx

---
title: "指南"
description: "了解如何通过最佳实践和工作流程创建高效文档。"
---

本节中的指南提供了关于如何创建文档的建议，帮助你的用户取得成功。无论你是从零开始，还是在改进现有文档，这些指南都能帮助你规划、撰写和维护文档。

最重要的是，要始终考虑用户的需求和目标。围绕能帮助他们使用你的产品并尽快回到自己任务的内容进行文档编写。

<div id="topics">
  ## 主题
</div>

<div id="ai-tools">
  ### AI 工具
</div>

使用 AI 驱动的工具加速你的文档工作流程。

* [自动化文档更新](/zh/guides/automate-agent)：教程，讲解如何使用 agent 设置文档的自动更新。
* [构建应用内 AI 助手](/zh/guides/assistant-embed)：教程，讲解如何在 React 应用中添加 AI 聊天机器人，帮助用户从你的文档中找到答案。
* [Claude Code](/zh/guides/claude-code)、[Cursor](/zh/guides/cursor)、[Windsurf](/zh/guides/windsurf)：使用 AI 编程助手维护文档的指南。
* [GEO](/zh/guides/geo)：为 AI 搜索和问答引擎优化文档的最佳实践。

<div id="api-documentation">
  ### API 文档
</div>

创建 API 文档，使用户能够测试并学习如何使用你的 API，并且便于维护。

* [从 MDX 迁移到 OAS](/zh/guides/migrating-from-mdx): 将你的 API 文档从单独的 MDX 页面迁移到基于 OpenAPI 规范自动生成的页面。

<div id="best-practices">
  ### 最佳实践
</div>

让你的文档做到行业一流。

* [Accessibility](/zh/guides/accessibility)：让尽可能多的用户都能无障碍使用你的文档。
* [Content types](/zh/guides/content-types)：为教程、操作指南、参考文档和解释性文档选择合适的形式。
* [Content templates](/zh/guides/content-templates)：为每种内容类型复用并修改相应的模板。
* [Improve your docs](/zh/guides/improving-docs)：利用数据和反馈持续改进你的文档。
* [Internationalization](/zh/guides/internationalization)：配置多语言文档，以触达全球用户。
* [Linking](/zh/guides/linking)：创建内部链接、引用 API 端点，并在整个文档中维护链接的完整性。
* [Maintenance](/zh/guides/maintenance)：保持文档准确且始终是最新的。
* [Media](/zh/guides/media)：在控制维护成本的同时，高效地添加图片、视频和其他媒体。
* [Organize navigation](/zh/guides/navigation)：设计符合用户习惯的信息架构。
* [SEO](/zh/guides/seo)：为搜索引擎优化你的文档。
* [Style and tone](/zh/guides/style-and-tone)：保持一致的文风和语气进行写作。
* [Understand your audience](/zh/guides/understand-your-audience)：研究并满足用户的需求和目标。

<div id="git-workflows">
  ### Git 工作流
</div>

了解 Git，以便在 Mintlify 中以及采用文档即代码（docs-as-code）的方法时发挥最大效用。

* [Git 基本概念](/zh/guides/git-concepts)：学习用于文档工作的 Git 基础知识。
* [Branch](/zh/guides/branches)：使用 branch 管理文档更改。

<div id="use-cases">
  ### 使用场景
</div>

了解 Mintlify 如何满足不同的使用需求，并找到适合你的解决方案。

* [创建开发者文档](/zh/guides/developer-documentation)：通过能够解答用户疑问、让他们迅速回到主要任务的开发者文档，帮助用户最大化发挥你的产品或 API 的价值。
* [创建知识库](/zh/guides/knowledge-base)：搭建内部知识库，为团队整合信息、提升搜索效率，并减轻维护负担。
* [创建支持中心](/zh/guides/support-center)：搭建自助式支持中心，帮助客户快速找到答案，减少工单数量，并提升客户满意度。

<div id="where-to-start">
  ## 从哪里开始
</div>

<CardGroup cols={2}>
  <Card title="文档新手？" icon="rocket" href="/zh/guides/content-types">
    了解内容类型，掌握如何设计文档结构。
  </Card>

  <Card title="要改进现有文档？" icon="chart-line" href="/zh/guides/improving-docs">
    了解如何使用指标和反馈来优化文档。
  </Card>

  <Card title="要配置 AI 功能？" icon="bot" href="/zh/guides/automate-agent">
    使用 agent 自动化更新文档。
  </Card>

  <Card title="与团队协作？" icon="git-merge" href="/zh/guides/git-concepts">
    学习适用于团队协作文档的 Git 工作流。
  </Card>
</CardGroup>