适用于大型语言模型（LLM）的文档

为您的文档站点提供 LLM 友好的版本

我们正在构建功能，使大型语言模型（LLM）更容易摄取并处理您的文档内容。

随着 LLM 在信息检索和知识辅助方面变得越来越重要，确保您的文档对 LLM 友好可以显著改善这些模型理解和呈现您的产品或服务的方式。

针对 LLM 优化的文档可确保像 ChatGPT、Claude、Cursor 和 Copilot 这样的 AI 系统能够检索并提供有关您的产品或 API 的准确、有上下文的回答。

.md 页面

在 GitBook 中，文档站点的所有页面都会自动以 markdown 文件的形式提供。如果您为任意页面添加 .md 扩展名，您将看到该页面的内容以 markdown 呈现，您可以将其传递给 LLM，以比处理 HTML 文件更高效地进行处理。

llms.txt 是一种建议的标准，用于以更易于 LLM 处理的基于文本的格式提供网页内容。您可以访问 llms.txt 页面，方法是在文档站点的根 URL 后追加 /llms.txt 。

该 llms.txt 文件作为您的文档站点的索引，提供所有可用的 Markdown 格式页面的完整列表。通过此文件，您可以使 LLM 更容易高效地发现并处理您的文档内容。

当 llms.txt 文件包含您文档站点所有页面 URL 和标题的索引时， llms-full.txt 文件则在一个文件中包含了您文档站点的完整内容，可作为上下文传递给 LLM。

LLM 可以使用此索引直接导航到页面的 Markdown 版本，从而在不需要解析 HTML 的情况下将您的文档纳入其上下文中。

GitBook 会为每个已发布的空间自动公开一个模型上下文协议（MCP）服务器。MCP 为 AI 工具提供了一种结构化方式来发现并检索您的文档作为资源——无需抓取。

通过在文档站点根 URL 后追加，您可以访问您的 MCP 服务器 /~gitbook/mcp 例如，GitBook 文档的 MCP 服务器位于 https://gitbook.com/docs/~gitbook/mcp.

在浏览器中访问此 URL 会导致错误。相反，您可以将其共享给能够发出 HTTP 请求的工具，例如 LLM 或 IDE。

阅读以下内容以了解更多信息已发布文档的 MCP 服务器.

现在您的 GitBook 站点会自动生成 .md 页面， llms.txt，和 llms-full.txt 文件，这些最佳实践将帮助 LLM 有效理解并处理您的内容。

通过使用这些优化，您也可能提升文档在 AI 驱动的搜索引擎和生成式引擎优化（GEO）中的表现。

最棒的是？这些指南通常也会使您的文档更易于人阅读。

使用良好的标题（H1、H2、H3）分隔内容，不要只写成一大段文字。要点、编号列表和较短的段落能让一切更易读。

保持简洁，除非确有必要，否则跳过复杂的技术术语。当您直截了当地表达意思而不加赘述时，LLM 表现会更好。

以示例说明，而不仅仅是描述。代码片段、API 示例和真实场景可以帮助 LLM（以及您的用户）理解事物在实践中如何运行。

没人喜欢过时的文档。定期更新可确保 LLM 不会向用户提供有关您最新功能和更新的错误信息。

实际尝试向 ChatGPT 或 Claude 提问有关您文档的问题，看看它们对您内容的理解程度。您可能会对哪些有效、哪些无效感到惊讶。

最后更新于28天前

这有帮助吗？