一个用 Rust 编写的命令行工具,可将 Markdown 文件生成为在线书籍,类似 GitBook。
- Star
- 29,069
- Fork
- 4,039
- 未关闭 Issue
- 91
- 最近提交
- 22小时前
这是什么?
GitBook 是一个面向团队的技术知识管理平台。本仓库是其开源的前端部分,负责渲染 GitBook 已发布的内容,因此基于 GitBook 搭建的文档站点可以通过这套代码展示。
项目基于 Next.js 和 TypeScript 构建,使用 Node.js 与 Bun 运行。启动本地开发服务后,可以通过 localhost 地址访问任意已发布的 GitBook 空间,修改代码后浏览器中会即时生效。Pull Request 会经过视觉和性能测试。
项目支持自行部署,可以定制已发布文档的外观,并将其嵌入自己的应用中。但自部署意味着需要自行负责站点的稳定性,并跟进平台的更新,官方仅建议在确有需求时采用。
核心功能
- 01基于源码渲染 GitBook 已发布的文档站点。
- 02采用 Next.js 与 TypeScript 构建。
- 03提供本地开发服务,可访问任意已发布的 GitBook 空间。
- 04支持自部署,并可定制页面外观。
- 05包含 GitBook 界面的多语言翻译文件。
适用场景
- 在自有域名下自部署 GitBook 发布的文档站点。
- 将 GitBook 渲染的文档嵌入自己的应用中。
- 定制已发布文档的界面外观。
- 为 GitBook 渲染引擎贡献代码修复或翻译。
快速上手
- 1
克隆仓库
git clone https://github.com/gitbookIO/gitbook.git - 2
使用 nvm 切换到项目指定的 Node 版本
nvm use - 3
使用 Bun 安装依赖
bun install - 4
启动本地开发服务器
bun dev
使用前须知
- 需要 Node.js 22.3 或更高版本以及 Bun 1.2.15 或更高版本。
- 采用 GPL-3.0 许可证,分发修改后的代码需要公开源码,或购买商业许可证。
- README 不推荐自托管,维护者也不保证对分支版本提供支持。
标签
常见问题
- gitbook 是什么?
- 开源的 Next.js 渲染引擎,用于呈现 GitBook 已发布的文档站点,也可自行部署。 GitBook 是一个面向团队的技术知识管理平台。本仓库是其开源的前端部分,负责渲染 GitBook 已发布的内容,因此基于 GitBook 搭建的文档站点可以通过这套代码展示。
- gitbook 可以免费使用吗?用的什么许可证?
- gitbook 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
- gitbook 还在维护吗?
- 活跃维护中。gitbook 最近一次提交是在 2026年10月21日。
- gitbook 适合用来做什么?
- 在自有域名下自部署 GitBook 发布的文档站点。 将 GitBook 渲染的文档嵌入自己的应用中。 定制已发布文档的界面外观。 为 GitBook 渲染引擎贡献代码修复或翻译。
- gitbook 怎么安装和运行?
- 克隆仓库: git clone https://github.com/gitbookIO/gitbook.git 使用 nvm 切换到项目指定的 Node 版本: nvm use 使用 Bun 安装依赖: bun install 启动本地开发服务器: bun dev
- 在哪里获取 gitbook?
- 源代码和安装说明在 GitHub 上:https://github.com/GitbookIO/gitbook
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
2.2万1908RustMPL-2.0更新于 19小时前
一个脚手架工具,把可编辑的 Astro 文档站点生成到你的仓库中,内置面向智能体的 Markdown 与 llms.txt 输出。
143152TypeScriptMIT更新于 3天前
开源的协作式 Wiki 与文档软件,可作为 Confluence 和 Notion 的开源替代方案。
2.2万1818TypeScriptAGPL-3.0更新于 3天前
开源 CMS,可直接在 GitHub 仓库中编辑内容和媒体,适用于 Jekyll、Hugo、Next.js、Astro 等静态站点。
4112578TypeScriptMIT更新于 6天前
一个单脚本的命令行与本地网页笔记、书签及知识库工具。
8453258ShellAGPL-3.0更新于 2个月前
面向 AI 智能体与团队的 Markdown 文件系统,支持全文与向量搜索、Git 版本管理,单个 Go 二进制文件即可运行。
837278GoOther更新于 3天前