如何将由多个.md文件组成的Jupyter Book项目转换为PDF格式？

前提准备 #

首先确保你已安装必要工具：

• Jupyter Book：pip install jupyter-book
• Pandoc：通过系统包管理器安装（比如Ubuntu用sudo apt install pandoc，macOS用brew install pandoc，Windows用系统包管理器或官方安装包）
• 完整TeX发行版：比如TeX Live（Ubuntu装texlive-full）、MacTeX（macOS）或MikTeX（Windows），这是渲染PDF的核心依赖。

项目配置检查 #

1. 确认项目根目录存在_config.yml文件，可添加PDF相关配置优化输出，示例：

   sphinx:
     config:
       latex_elements:
         papersize: a4paper
         pointsize: 12pt
       latex_documents:
         - targetname: book.tex
   

2. 检查_toc.yml是否正确配置，确保所有需要纳入PDF的.md文件都在目录结构中，否则这些文件不会被包含进最终PDF。

生成PDF #

进入你的Jupyter Book项目根目录，运行以下命令：

jupyter-book build --builder pdf ./

如果你的项目文件夹不在当前工作目录，替换./为项目的完整路径。

生成完成后，PDF文件会存放在项目根目录的_build/pdf文件夹下，默认文件名为book.pdf。

常见问题排查 #

• TeX相关报错：大概率是TeX发行版不完整，安装完整版本（如texlive-full）可解决多数宏包缺失问题。
• Markdown内容不渲染：确认语法符合Jupyter Book支持的规范（比如数学公式用$...$或$$...$$，表格用标准Markdown格式）。
• 排版异常：调整_config.yml中的latex_elements配置，或检查_toc.yml的层级结构是否合理。

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