从Bookdown迁移至纯Pandoc：将HTML输出拆分为单节单页

核心方案：Pandoc内置章节拆分功能 #

Pandoc 2.11及以上版本自带--split-chapters参数，无需依赖R或Bookdown，就能直接生成类似gitbook的多页面HTML书籍，同时保留跨章节引用、统一目录和参考文献功能。

具体操作步骤 #

1. 准备源文件
   要么把所有章节的MD文件按顺序合并成单个文件（比如book.md），要么直接让Pandoc批量读取多个章节文件：

   pandoc chapter1.md chapter2.md chapter3.md --split-chapters -o book.html
   

   注意章节必须用Markdown一级标题（#）划分，Pandoc会自动识别每个一级标题为独立章节。

2. 处理跨章节引用与参考文献

   • 若有文献引用（如[@citekey]），需指定参考文献文件（如refs.bib）并加上--citeproc参数：

     pandoc *.md --split-chapters --citeproc --bibliography=refs.bib -o book.html
     

   • 跨章节的内部链接（如[章节标题](#chapter-title)）会被Pandoc自动转为跨页面链接，无需手动调整。

3. 侧边栏目录与脚注
   Pandoc默认HTML模板会自动生成包含全章节的侧边栏目录；脚注会自动放在对应章节的页面底部，和gitbook的行为一致。

4. 优化输出结构
   若想把章节文件统一放在子目录（如chapters/），可添加--output-dir参数：

   pandoc *.md --split-chapters --output-dir=chapters --citeproc --bibliography=refs.bib -o book.html
   

   生成的book.html作为首页承载完整目录，每个章节对应单独的HTML文件（如chapters/chapter1.html）。

兼容旧版Pandoc的替代方案 #

如果你的Pandoc版本低于2.11，可通过简单脚本实现：

1. 先合并所有MD文件生成带交叉引用标记的辅助文件，提取资源并生成章节标签映射。
2. 按章节拆分文件，用Pandoc分别转换每个章节，同时传递引用数据。
   不过这种方法比内置功能繁琐，优先推荐升级Pandoc到最新版本。

内容的提问来源于stack exchange，提问作者DPD-