# 适用于 LLM 的文档
我们正在构建一些功能，让大型语言模型（LLM）更容易摄取并处理你的文档内容。
随着 LLM 在信息检索和知识辅助方面变得越来越重要，确保你的文档对 LLM 友好可以显著提升这些模型理解并表述你的产品或服务的方式。
经过 LLM 优化的文档可确保 ChatGPT、Claude、Cursor 和 Copilot 等 AI 系统能够检索并提供关于你的产品或 API 的准确、具有关联上下文的响应。
## .md 页面
借助 GitBook，你文档站点的所有页面都会自动以 markdown 文件的形式提供。如果你为任何页面添加 `.md` 扩展名，你就会看到该页面的内容以 markdown 形式呈现；与 HTML 文件相比，你可以将其传递给 LLM 进行更高效的处理。
查看此页面的 .md 文件
## llms.txt
[llms.txt](https://llmstxt.org/) 是一项拟议中的标准，旨在以更适合 LLM 处理的基于文本的格式提供网页内容。你可以通过在文档站点的根 URL 后追加 `llms.txt` 页面，访问 `/llms.txt` 。
该 `llms.txt` 文件充当你文档站点的索引，提供所有可用的 markdown 格式页面的完整列表。借助这个文件，你可以让 LLM 更轻松地高效发现并处理你的文档内容。
查看 GitBook 文档的 /llms.txt
## llms-full.txt
其中 `llms.txt` 文件包含你文档站点中所有页面 URL 和标题的索引， `llms-full.txt` 则以一个文件的形式包含你文档站点的全部内容，可作为上下文传递给 LLM。
查看 GitBook 文档的 /llms-full.txt 文件
LLM 可以使用这个索引直接导航到你页面的 markdown 版本，从而无需解析 HTML 就能将你的文档纳入其上下文。
## MCP 服务器
GitBook 会为每个已发布的空间自动公开一个模型上下文协议（MCP）服务器。MCP 为 AI 工具提供了一种结构化方式来发现并检索你的文档作为资源——无需抓取。
你的 MCP 服务器可通过在以下地址后追加 `/~gitbook/mcp` 来访问文档站点根 URL。例如，GitBook 文档的 MCP 服务器位于 `https://gitbook.com/docs/~gitbook/mcp`.
{% hint style="info" %}
在浏览器中访问此 URL 会报错。相反，你可以将其分享给能够发出 HTTP 请求的工具，例如 LLM 或 IDE。
{% endhint %}
了解更多，请阅读 [mcp-servers-for-published-docs](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/ai-yu-sou-suo/mcp-servers-for-published-docs "mention").
## 为 LLM 优化文档的技巧
现在你的 GitBook 站点会自动生成 `.md` 页面， `llms.txt`，以及 `llms-full.txt` 文件，这些最佳实践将帮助 LLM 有效理解并处理你的内容。
通过使用这些优化，你还可以提升文档在 AI 驱动搜索引擎以及生成式引擎优化（GEO）中的表现。
最棒的是？这些指南通常也会让你的文档更易于人类阅读。
### 使用清晰的层级结构
用合适的标题（H1、H2、H3）来拆分内容，不要只写成一大段文字。项目符号、编号列表和更短的段落都能让内容更易阅读。
### 撰写简洁、无行话的内容
保持简单，除非确有必要，否则跳过复杂的技术术语。当你清楚表达意思而不加入冗余内容时，LLM 的表现会好得多。
### 加入实际示例
展示，而不只是讲述。代码片段、API 示例和真实场景能帮助 LLM——以及你的用户——理解实际中事物是如何运作的。
### 保持内容及时且准确
没人喜欢过时的文档。定期更新意味着 LLM 不会向人们提供有关你最新功能和更新的错误信息。
### 使用 AI 工具进行测试
实际尝试向 ChatGPT 或 Claude 提问有关你文档的问题，看看它们对你的内容理解得如何。你可能会对哪些有效、哪些无效感到惊讶。