GitBook 与 Docsbook：定价、供应商锁定与迁移

GitBook 是 Zoom、FedEx、Nvidia 以及众多中型市场和企业团队首选的文档平台。它外观精美，拥有易于使用的所见即所得编辑器，而且 AI 搜索功能确实有效。

那么，为什么团队还会寻找 GitBook 的替代方案呢？

因为签订 GitBook 合同两年后，大多数团队都会注意到同样的三件事：团队中每增加一名编辑，账单就会随之增加；内容存储在 GitBook 的数据库中，而不是他们自己的代码仓库中；这个曾承诺永久处理其文档的平台，如今却不得不迁移出去。

这篇文章将进行坦诚的比较。我们开发了 Docsbook，因此会告诉你它何时更具优势。但 GitBook 是一款真正的产品，拥有切实的优点，也有一些团队更适合使用它而不是我们。我们会告诉你这些团队是哪类。

简而言之 — 决策矩阵#

如果你只读一行：GitBook 的定价和构建方式面向拥有文档负责人和预算项目的团队。Docsbook 的定价和构建方式面向这样一类团队：文档与代码一起存放在 docs/ 中，而且没人想维护一个独立的文档系统。

团队离开 GitBook 的原因#

在我们与从 GitBook 迁移到 Docsbook 的新客户进行的每次流失访谈中，都会出现四个原因。

1. 账单会随着编辑人数的增加而增长#

GitBook 的定价有两个维度。根据其 2026-09-03 的官方定价页面 gitbook.com/pricing，免费版的价格为每个站点每月 0 美元，包含一名用户；高级版的价格为每个站点每月 65 美元，另加每位用户每月 12 美元；终极版的价格为每个站点每月 249 美元，另加每位用户每月 12 美元；企业版需咨询。读者无需付费——按用户收取的费用适用于在 GitBook 应用内协作处理内容的人员。

这种定价模式有一个值得直说的后果：每增加一位可能修复错别字的同事，账单上就会多出一笔经常性费用。这是一种自洽的模式——它为所见即所得编辑器、变更请求流程和销售团队提供资金——但它对大多数产品团队希望增加的事情定价了，而这件事正是让更多工程师参与文档编辑。

Docsbook 不按编辑者收费，也不提供分级套餐。每个项目都有自己的余额，余额用于支付 AI 使用费用；发布站点、托管站点、提供自定义域名以及读者打开的每个页面都不会消耗余额。GitHub 团队中的任何人都可以编辑底层 Markdown，因为编辑器就是他们已经在使用的工具。当前价格请参阅 docsbook.io/pricing。

2. 供应商锁定是真实存在的#

GitBook 的 Git Sync 是一项附加功能，即使启用了它，权威来源仍然是 GitBook 的数据库。如果你停止付费，你的内容不会继续保留在你可以继续处理它的地方。

我们已经三次看到同样的情况：一个团队决定离开，导出他们的内容，然后发现导出结果是一个 Markdown 文件的 ZIP 压缩包，其结构与他们的代码仓库不匹配，图片链接还指向 GitBook 的 CDN。迁移不是一个按钮，而是一个项目。

Docsbook 采用相反的模式。你的 Markdown 文件位于 GitHub 代码仓库中。我们为其建立索引、渲染并发布。如果你停止付费，文档仍然保留在 docs/ 中——你失去的是托管网站、AI 聊天和翻译功能。资源仍归你所有，因为它从未被迁移。

3. 从 Docusaurus 迁移或从 Markdown 迁移，成本减半#

如果你的文档目前存放在由 Markdown 文件组成的 docs/ 文件夹中（大多数工程团队都这样存放），要迁移到 GitBook，就意味着将它们粘贴到 GitBook 编辑器中，或配置 Git Sync 并祈祷导入过程能够正确处理你的 front matter、自定义组件和图片路径。

大多数团队都低估了这一点。GitBook 的编辑器是基于块的编辑器，而不是 Markdown 编辑器——因此，MDX 组件、以 :::note 形式编写的提示框，以及在 Markdown 中能够正常工作的表格，要么渲染效果略有偏差，要么需要重新制作。

Docsbook 会原样读取你的 Markdown。如果 README.md 和一个 docs/ 文件夹在 GitHub 上能够正常工作，那么它们在 Docsbook 上 5 秒内也能正常工作。Frontmatter、GFM 表格、代码围栏、图片链接——全部无需任何重新格式化即可渲染。

4. AI 搜索不再是护城河，而只是必选项#

2024 年，AI 搜索是付费使用 GitBook 的理由。到了 2026 年，所有严肃的文档平台都已提供这项功能。问题不再是“你是否提供 AI”，而是“在我已经支付的编辑器席位费用之上，AI 还要收费多少，以及我的 AI 流量来自哪里”。

Docsbook 按美元计量 AI 使用量，并从项目余额中扣除，而不是将其限制在某个套餐层级之后，因此也就不存在“哪个套餐包含 AI”这个问题。MCP 服务器已包含在内，这意味着 Claude Code 和 Cursor 用户可以直接读取和编辑你的文档，而 llms.txt 和 llms-full.txt 则会在平台层面和每个工作区中自动发布。

最后这一点的重要性超乎表面。Mintlify 对其托管的文档网站进行了为期 30 天的流量测量——大约 7.9 亿次请求——并报告称，AI 编程代理占全部请求的 45.3%，其中 Claude Code 占 25.2%，Cursor 占 18.0%（文档领域代理流量的现状，发布于 2026 年 4 月 3 日）。其后续测量显示，2026 年 7 月代理流量占比已达到 66%（文档流量现状：2026 年年中报告，发布于 2026 年 7 月 29 日）。这只是某一家供应商所管理的站点数据，并不代表整个互联网——但这是目前已发布的、针对文档的代理流量的最大规模测量，而其发展方向也已经十分明确。

功能对比#

这两种定价模型实际上如何比较？#

它们不能作为两个数字进行比较，因为它们计量的是不同的东西——而这种差异正是整个决策的核心。

这会带来两个后果。在 GitBook 上，最便宜的文档团队规模较小，因此这种模式在不知不觉中抑制了大多数工程组织所希望的做法——让更多工程师编辑文档。在 Docsbook 上，最便宜的文档团队是这样一种团队：读者能在页面上找到答案，而不是向助手提问，因此这种模式会奖励页面内容的编写。

请在供应商自己的页面上，根据您团队的实际规模进行计算。本文特意不发布任何完整示例：GitBook 的数字会发生变化，我们的数字按请求生成，而将两者列成表格会在发布后不到一个季度内就失效。docsbook.io/pricing 会在每次请求时根据实时定价常数重新生成，因此这是唯一值得我们引用的数字。

迁移路径：GitBook → Docsbook#

如果你正在考虑迁移，以下是实际可行的路径。我们已经多次见证这一过程。

1. 从 GitBook 导出。 使用 GitBook 的空间导出功能，将内容导出为 Markdown。预计需要手动修复图片路径以及块编辑器产生的各种问题——具体需要半天到一天，取决于你使用了多少自定义块。
2. 将文件放入任何 GitHub 仓库中的 docs/ 文件夹。 公有或私有仓库均可。如果你还没有仓库，请创建一个。
3. 将仓库 URL 粘贴到 Docsbook。 网站将在 5 秒内于 docsbook.io/owner/repo 上线。请验证所有内容是否正常呈现。
4. 连接你的自定义域名。 将 DNS 指向 Docsbook，以通过自动 SSL 提供 docs.yourcompany.com。
5. 启用 AI 聊天和翻译。 这是可选功能，但启用成本很低。大多数团队会在同一天启用它们。
6. 在旧的 GitBook 域名上设置重定向。 使用 Cloudflare Workers、Netlify 或重定向服务，将 *.gitbook.io/yourspace/* 重定向到新路径。
7. 取消 GitBook。

整个过程通常只需一到两天。最耗时的部分是修复导出 Markdown 中的块编辑器问题，而这只是一次性成本。

GitBook 实际上更适合的情况#

我们更希望您继续使用 GitBook，而不是购买 Docsbook 后感到失望。以下是 GitBook 真正更适合的情况。

• 您的文档编辑人员不具备技术背景。GitBook 的所见即所得编辑器让产品经理、支持负责人和撰稿人无需学习 Markdown 或 Git 就能参与编辑。如果一半编辑人员都不知道拉取请求是什么，那么 GitBook 就是合适的工具。
• 您需要实时协同编辑。GitBook 支持在浏览器中进行实时的多用户编辑。Docsbook 不支持——您的协作模式是“git push”。
• 您需要在编辑器内使用带分支的工作流和变更请求。GitBook 的变更请求界面已经相当成熟。Docsbook 将这部分交给 GitHub PR；如果您的编辑人员是工程师，这是正确的选择，而如果他们不是，则并非如此。
• 您正在为一个要求 SOC 2 Type II、SAML SSO 和专属 CSM 的企业团队购买产品。GitBook 已将这些全部打包提供。Docsbook 正在朝这个方向发展，但目前还未达到这一水平。
• 您已经在使用 GitBook，团队对此感到满意，并且费用可以接受。迁移成本是实际存在的。如果当前配置运行良好，就不要修复并未损坏的东西。

如果以上情况都不适用于您，那么 Docsbook 几乎肯定是更合适的选择。

常见问题#

Docsbook 是开源的吗？ 不，但您的内容是开源的。您的 Markdown 文件存放在 GitHub 仓库中，您可以随时停止为托管网站付费，而不会失去对任何页面的访问权限。

Docsbook 支持私有仓库吗？ 支持。您授权 Docsbook 读取私有仓库，发布的网站也可以根据您的设置设为私有或公开。

我可以继续在 GitBook 中编辑，并同步到 Docsbook 吗？ 可以，但这违背了这样做的初衷。请选择一个唯一的事实来源。如果 GitBook 属于您，就继续使用 GitBook；如果 GitHub 属于您，就迁移过来。

迁移后我的 SEO 会怎样？ 为每个旧 GitBook URL 设置 301 重定向，将其指向对应的 Docsbook 路径。搜索引擎会遵循 301 重定向，并传递排名信号；忘记设置重定向的路径会失去流量。Docsbook 默认会为每个页面生成 meta 标签和 JSON-LD，因此新页面不会缺少旧页面已有的标记——但任何平台都无法保证您的排名，Docsbook 也不例外。

Docsbook 有像 GitBook 一样的 AI 搜索吗？ 有。AI 聊天基于您自己的文档进行训练，其费用按美元从项目余额中计量扣除，而不是限制在某个套餐等级之后。您也可以使用自己的 API 密钥——OpenRouter、OpenAI、Anthropic 或 Gemini——直接向服务提供商支付费用。

我可以自定义外观和风格吗？ 可以。您可以设置徽标、网站图标、浅色和深色模式的强调色、Google Fonts，以及各组件的可见性开关——搜索栏、复制按钮、“在 GitHub 上编辑”链接、AI 聊天按钮等。唯一无法关闭的是页面页脚中小巧的“Powered by Docsbook”链接：它会无条件地显示在每个 Docsbook 网站上。

坦诚地说#

GitBook 对特定受众来说是一款优秀的产品：希望使用所见即所得编辑、实时协作，并且不介意按编辑者人数付费的中型市场和企业团队。

Docsbook 则适合另一类受众：文档已经存放在 GitHub 中、不希望将内容放进供应商数据库，并且更愿意为 AI 实际完成的工作付费，而不是为获准编辑的人数付费的团队。

如果您属于第一类受众，GitBook 是正确的选择。如果您属于第二类，Docsbook 更适合——而决定性因素不是今天的价格，而是团队扩大时哪个数字会增长。

免费开始 — 无需信用卡

后续步骤#

• 从 GitBook 迁移到 Docsbook — 导出、导入和重定向列表
• 2026 年 Docusaurus 替代方案：9 个平台对比 — 更广泛的选择范围，如果 GitBook 不是你的唯一候选方案
• AI 文档平台对比 — 四个托管平台的 AI 功能矩阵
• 文档自定义域名 — docs.yourcompany.com 的 DNS 和 SSL 步骤