如何设置Bookdown让Gitbook章节编号从0开始?
当然可以实现!我整理了几种实用的方案,根据你的需求和Gitbook使用习惯选就行:
方案1:用自定义编号插件(推荐,自动化程度高)
Gitbook有专门的插件支持自定义章节编号,步骤很简单:
- 在你的Gitbook根目录下的
book.json文件里,添加插件配置:
{ "plugins": ["custom-numbering"], "pluginsConfig": { "custom-numbering": { "sections": [ { "path": "练习作业", // 替换成你「练习作业」章节的实际文件路径,比如"practice/intro.md" "number": 0 }, { "path": "计分实验1", // 第一个计分实验的文件路径 "number": 1 }, { "path": "计分实验2", "number": 2 } // 继续添加剩下的3-6号计分实验章节配置 ] } } }
- 安装插件:在终端里运行
gitbook install - 重新构建或预览Gitbook,章节编号就会按照你设定的规则显示了。
方案2:手动修改章节标题(简单直接,适合章节固定的情况)
如果不想折腾插件,直接给章节标题加编号最省事:
- 把「练习作业」的标题改成
# 0. 练习作业 - 后续的计分实验依次改成
# 1. 计分实验1、# 2. 计分实验2……直到# 6. 计分实验6 - 这种方式不需要额外配置,但如果后续调整章节顺序,记得手动同步编号哦。
方案3:自定义Gitbook核心逻辑(进阶,适合有开发能力的用户)
如果你是自己部署的Gitbook环境,也可以直接修改它的章节编号生成逻辑:
- 找到Gitbook处理章节编号的核心模块(通常在
node_modules/gitbook/lib目录下) - 调整编号起始规则,给第一个章节强制赋值为0,后续章节从1开始递增
- 这种方式灵活性最高,但需要你熟悉Gitbook的源码,而且版本更新后可能需要重新修改,不推荐普通用户使用。
小提示
- 如果用插件,记得确认插件和你的Gitbook版本兼容,部分旧版本Gitbook可能对新插件支持不佳
- 不管用哪种方式,建议先在本地预览效果,再推送到线上环境
内容的提问来源于stack exchange,提问作者Martina
相关产品推荐
相关产品推荐

