Gitbook

慕名来搭文档站，打开发现不是你以为那个GitBook

做过开源项目的人大概都有过这个经历：想找个工具给项目搭个像样的文档站，听人说”用GitBook”，打开 gitbook.com 注册完才发现，这是一个在线SaaS平台，不是早年GitHub上那个 gitbook-cli 命令行工具——注册付费、在线编辑、协作评审，一切都在浏览器里完成。很多老开发者的第一反应是：”我想生成静态Markdown文档，这个怎么用？”这里先把这桩公案讲清楚：‌2014年那个开源的GitBook CLI 命令行工具早已停止维护‌，现在npm上默认的gitbook包已经是最新SaaS版的同步工具，想用开源静态文档生成的老用户可以转用社区复刻的Honkit，现在的gitbook.com是面向团队的‌商业化技术文档平台‌。

从开源工具长成的SaaS文档平台

GitBook 最早起源于2014年在GitHub上开源的命令行文档生成工具（创始人Samy Pessé等），当时是最流行的Markdown书籍/文档站生成器之一，很多早期开源项目的文档都用它构建（最典型的是各类开源教程”xxx-GitBook”）。后来团队把产品重心转向在线协作，关闭了旧的工具链，gitbook.com 这个域名正式承载‌GitBook Inc.‌运营的SaaS产品。现在它的定位是”现代团队文档平台”，核心服务对象是软件开发团队、SaaS公司、技术布道师和产品团队，用来构建三类东西：公开的产品文档站/帮助中心/开发者门户，团队内部的技术Wiki和知识库，以及代码仓库配套的API参考文档。

核心是Git原生+AI做技术写作

它和Notion、语雀这类通用文档工具最根本的差异，在于‌整个产品是给技术写作设计的‌。第一是‌Git原生集成‌：文档可以直接对接GitHub/GitLab仓库，代码更新时文档自动同步，文档改动也走版本控制，对用Git做代码管理的团队来说是零摩擦——不用在文档平台和代码仓库之间手动来回搬。第二是 ‌GitBook AI（Lens，现在叫GitBook AI）‌：这是它这两年最核心的卖点，可以‌直接从代码仓库提取信息自动生成API文档、函数说明和代码示例‌，维护文档不用再手动对照代码改；AI搜索支持语义检索（不是简单关键词匹配），在一大堆技术文档里找答案比传统搜索快，这对大型内部Wiki特别实用。第三是专业文档的能力：支持丰富的内容块（代码块、API块、表格、卡片、Mermaid图表、可折叠块等），‌变更请求（Change Requests）+ 多人评审‌机制走的是类似PR的流程，文档修改需要审阅合并，适合正式文档而不是随手笔记；Slack、Intercom、Linear等工具可集成，客户支持、产品、研发在文档上协作。

公开站漂亮、私密Wiki够用

它最知名的一面是‌公开文档站‌：默认主题清爽专业、响应式适配好、自带目录导航和搜索，全球大量SaaS产品和开源项目的帮助中心/开发者文档都长这个样子，读者看着不累，SEO友好。私有的团队空间（Internal Wiki）用来沉淀内部技术资料、架构文档、新人Onboarding材料，配合权限分级控制谁能看谁能改。2025年之后推出的 ‌GitBook Snippets‌ 让你在文档里直接嵌入可运行的代码片段、API调用块，开发者复制就能用，对写API文档特别方便。

价格档位

按官网公开口径是美元计价，分四档：‌Free（免费）‌ 给个人和小团队试水用，空间和协作人数有限；‌Plus‌ 按席位约 6.7美元/月（年付折算更低）；‌Pro‌ 约12.5美元/月每席位（含完整AI能力、高级权限、集成、SAML SSO）；‌Enterprise‌ 需要单独询价，带更多企业级安全、审计、私有部署选项。新文档站一般还会提供自定义域名绑定。‌具体价格、AI额度和席位限制以官网实时显示为准‌；按席位订阅为自动续费，团队人数变动记得及时调整。

该提醒的几条现实问题

第一，‌国内访问不稳定‌：服务器在海外，官方没有面向中国大陆的本地化服务，和Notion的情况类似，国内打开和编辑速度时好时坏、协作时可能断连；请按你所在的网络环境与当地相关规定使用，‌不提供任何绕过网络限制的方法‌。第二，‌不要把它当成2014年的开源GitBook CLI‌：想本地用命令行生成静态Markdown站点、要开源免费，应该看Honkit（社区维护分支）或MkDocs、Docusaurus、VitePress这类现代静态文档生成器，而不是注册这个SaaS。第三，‌它做不了通用笔记工具‌：没有多维表格、没有待办清单、没有知识库之外的通用能力，写日常笔记、做项目管理用它是错的，它就是给技术文档用的。第四，‌数据在海外云‌，涉密代码、未公开产品文档、公司内部资料不要传；重要文档本地导出备份一份。第五，‌认准域名 gitbook.com‌，早期教程里的旧CLI指令和npm包已不适配SaaS产品，别装第三方”GitBook破解版”。

‌FAQ‌

‌Q1：GitBook官网是哪个？它还开源吗？‌
官网入口为 https://www.gitbook.com/。需要区分：2014年前后开源的命令行静态文档生成器（gitbook-cli）已经停止维护，社区接手维护的复刻版本叫 Honkit；现在的 gitbook.com 是 GitBook Inc. 运营的SaaS技术文档平台，原生集成Git与AI写作能力，不是开源静态站生成器。

‌Q2：国内能稳定用吗？免费版够用吗？‌
服务器在海外，官方没有中国大陆本地化服务，国内访问速度和稳定性因网络环境而异，请按实际情况和当地规定使用。Free免费档适合个人和小团队试用，空间和协作人数有限；Plus约6.7美元/月每席位、Pro约12.5美元/月每席位，价格以官网实时为准，Pro档含完整AI能力与高级权限。

‌Q3：和Notion、语雀、MkDocs有什么区别？‌
Notion是通用块+数据库工作台，适合所有内容和项目管理但不是专门为技术写作设计；语雀是国产结构化知识库，适合团队知识沉淀；MkDocs/Docusaurus/VitePress是开源静态站生成器，本地命令行构建后自己部署；GitBook是专为技术团队打造的在线SaaS，强项在Git原生、AI自动从代码生成API文档、专业文档站外观和变更评审流程，做开发者文档和内部技术Wiki最合适。

首页截图