GitBook 与 GitHub 的关系-Day24

一、公司背景与基本信息

1.1 GitBook

项目 详情
公司全称 GitBook Inc.
成立时间 2012 年
总部地址 440 N Barranca Ave #7171, Covina, CA 91723, USA
EIN(税号) 320502699
公司性质 私人公司(Private)
员工规模 约 38 人(2025 年)
创始人 Samy Pessé(联合创始人/CTO)、Marc Pessé(联合创始人)
现任 CEO Sara Tandowsky(2023 年 3 月上任)
融资情况 累计融资约 $197K,投资方包括 Fly Ventures、Point Nine Capital
行业领域 商业/生产力软件(Business/Productivity Software)

GitBook 最初是一个基于 Git 的开源电子书制作工具,后逐步转型为面向技术团队的文档与知识管理平台。

1.2 GitHub

项目 详情
公司全称 GitHub, Inc.
成立时间 2008 年 4 月
总部地址 88 Colin P. Kelly Jr. Street, San Francisco, CA 94107, USA
母公司 Microsoft Corporation(微软)
收购时间与金额 2018 年 6 月 4 日宣布收购,2018 年 10 月 26 日完成,交易价值 75 亿美元(全股票)
创始人 Tom Preston-Werner、Chris Wanstrath、PJ Hyett
历任 CEO Chris Wanstrath → Nat Friedman(微软收购后)→ Thomas Dohmke(2021--2025)
产品定位 全球最大的代码托管与软件开发协作平台

GitHub 总部位于旧金山 SOMA 区,办公面积约 55,000 平方英尺,另在阿姆斯特丹等地设有分部。

二、核心功能对比

2.1 GitBook 核心功能

GitBook 是一款以文档为中心的知识管理平台,主打"Docs-as-Code"理念,核心功能包括:

功能模块 说明
可视化编辑器 基于 Block 的 WYSIWYG 编辑器,支持拖拽排版,非技术人员也能快速上手
Markdown 支持 原生支持 Markdown 语法,技术团队可直接用熟悉的方式编写
Git 双向同步 与 GitHub、GitLab 仓库双向同步,文档变更可生成 Git Commit,代码侧修改也可自动同步回 GitBook
OpenAPI/Swagger 集成 自动生成 API 参考文档,支持 REST、GraphQL 等接口文档化
AI 助手(GitBook Agent) AI 驱动的文档维护、内容补全、智能搜索、MCP 服务器生成
变更请求(Change Request) 类似 Pull Request 的文档审阅流程,支持分支预览与合并规则
多格式发布 支持发布为 Web 站点、PDF、电子书等格式
SSO 与企业安全 支持 SAML SSO,通过 SOC 2 Type II 和 ISO 27001 认证
自定义域名与品牌化 支持自定义域名、主题配色、Logo 替换

GitBook 在 2024--2025 年重构了定价模式,采用"站点+用户"双轨计费:站点计划(Free/Premium 79/月/Ultimate 299/月)与用户计划(Free/Plus 10/人/月/Pro 15/人/月)分开购买。

2.2 GitHub 核心功能

GitHub 是一款以代码为中心的软件开发协作平台,核心功能包括:

功能模块 说明
Git 仓库托管 分布式版本控制,支持无限公共/私有仓库
Pull Request 代码变更的提交、审阅、讨论与合并流程
Issues Bug 追踪、需求管理、任务分配
GitHub Actions 原生 CI/CD 流水线,支持自动化构建、测试、部署
GitHub Copilot AI 编程助手,基于 OpenAI Codex 模型,支持代码补全与生成
Codespaces 云端开发环境,浏览器内即可编写、运行、调试代码
GitHub Pages 免费静态站点托管,可直接从仓库发布网站
GitHub Packages 软件包管理,支持 npm、Docker、Maven 等
Wiki 每个仓库附带的轻量级文档系统
Security 功能 Dependabot 漏洞扫描、代码扫描、密钥检测
Discussions 社区论坛式讨论区,替代传统 Issues 进行 Q&A

GitHub 拥有超过 1 亿开发者用户,是全球最大的开发者社区。

三、两者关系:协作而非隶属

3.1 无股权关系

GitBook 与 GitHub 是完全独立的两家公司,不存在投资、收购或隶属关系:

  • GitBook 是私人持有的独立创业公司,总部在加州 Covina
  • GitHub 是微软(Microsoft)的全资子公司,总部在旧金山

3.2 深度技术集成

尽管独立运营,GitBook 与 GitHub 之间存在深度产品集成

集成方式 说明
Git 双向同步 GitBook 空间可与 GitHub 仓库关联,任何一方的修改都会同步到另一方
GitHub App 安装 GitBook 的 GitHub App 后,可在 PR 中预览文档变更效果
GitHub 登录 支持使用 GitHub 账号单点登录 GitBook
Change Request ↔ Pull Request GitBook 的文档审阅流程与 GitHub 的代码审阅流程打通
分支预览 文档分支可生成预览链接,类似 GitHub 的部署预览

这种集成使得许多技术团队采用**"GitHub 管代码,GitBook 管文档"**的组合策略:代码仓库放在 GitHub,产品文档、API 文档放在 GitBook,两者通过 Git 同步保持版本一致。

3.3 典型使用场景

复制代码
┌─────────────────────────────────────────────┐
│              典型项目架构示例                 │
├─────────────────────────────────────────────┤
│  GitHub(代码侧)                             │
│  ├── 源代码仓库                               │
│  ├── CI/CD 流水线(Actions)                  │
│  ├── Issue 追踪                               │
│  └── Pull Request 审阅                        │
├─────────────────────────────────────────────┤
│  GitBook(文档侧)                            │
│  ├── API 参考文档(OpenAPI 自动生成)          │
│  ├── 开发者指南                               │
│  ├── 产品使用手册                             │
│  └── 内部知识库                               │
├─────────────────────────────────────────────┤
│  连接:Git 双向同步 + GitHub App 集成          │
└─────────────────────────────────────────────┘

四、定位差异与选型建议

维度 GitBook GitHub
核心定位 文档与知识管理平台 代码托管与协作开发平台
主要用户 技术写作者、产品经理、开发者 软件开发者、DevOps 工程师
内容类型 API 文档、产品手册、知识库、开发者门户 源代码、配置文件、Issue、PR
版本控制 基于 Git 的文档版本管理 原生 Git 分布式版本控制
协作模式 WYSIWYG 编辑器 + Change Request 代码编辑器 + Pull Request
AI 能力 文档生成、智能搜索、内容补全 代码生成(Copilot)、智能审阅
部署能力 文档站点发布、PDF/电子书导出 静态站点(Pages)、容器镜像、CI/CD
社区规模 数千家企业客户 1 亿+ 开发者
定价模式 站点费 + 用户费 免费版 + Team/Enterprise 按座席

选型建议

  • 选择 GitBook :如果你的团队需要构建面向开发者或客户的专业文档站点(尤其是 API 文档),并且希望文档工作流与代码工作流保持一致(Docs-as-Code)。
  • 选择 GitHub :如果你的团队需要托管代码、管理版本、进行代码审阅和持续集成,GitHub 是基础设施级的选择。
  • 组合使用 :绝大多数技术团队实际上同时使用两者------GitHub 管理代码生命周期,GitBook 管理文档生命周期,通过 Git 集成实现无缝协作。

五、总结

GitBook 与 GitHub 名称相似(都含"Git"),且都服务于技术人群,但本质上是不同赛道、不同公司、不同产品

  • GitBook = 独立的法国/美国创业公司(38 人)→ 专注文档与知识管理
  • GitHub = 微软旗下巨头(1 亿+ 用户)→ 专注代码托管与开发协作
  • 关系 = 无股权关联,但通过 Git 协议和官方 App 实现深度产品集成

对于现代软件团队而言,两者不是替代关系,而是互补关系------GitHub 解决"如何写代码",GitBook 解决"如何写文档"。

相关推荐
dong_junshuai1 小时前
每天一个开源项目#74 OpenViking:3万星Agent上下文数据库
开源·github·agent
胡萝卜术2 小时前
从"氛围编程"到规范驱动:两次创造如何让 AI 协作从碰运气变成工程流水线
前端·面试·github
小弥儿2 小时前
GitHub今日热榜 | 2026-08-20:Agent 上下文数据库接棒
数据库·学习·开源·github
小妖同学学AI2 小时前
GitHub上16k星的“未来编辑器”:像Notion一样排版,像ChatGPT一样自动续写
编辑器·github·notion
程序员阿卢2 小时前
Github Copilot 新手极速上手指南
github·copilot·ai编程助手·开发工具集成
小帅不太帅2 小时前
我把金博士使用 GPT 证明 Crouzeix 猜想的方法做成了一个 deep-learn 技能
前端·github·agent
三十而立洋2 小时前
GitHub 项目创建指南:实际应用场景与常见权限问题详解
github
秣宇3 小时前
银河麒麟服务器操作系统关闭 Swap 分区
linux·运维·服务器·github·kylin
你要飞4 小时前
VSP3 转 STL
笔记·github