不装 LaTeX 把 Jupyter Notebook 转成 PDF

把 notebook 变成 PDF 的官方办法是 nbconvert，它确实好用——前提是你有一套能跑的 LaTeX 环境。而要有这个环境，你得装一个以 GB 计的 TeX 发行版，然后去排查那些提到你从没听过的文件名的缺包报错。为了给导师发一份 PDF 或者往报告里附一页，这个准备工作有点多。

如果你需要期刊级的排版，nbconvert 加 LaTeX 仍然是正确的工具。如果你只需要一份能读的分析 PDF，有一条短得多的路。

notebook 是一份 JSON 文档。里面是一个有序的单元格列表，每个格子标注为 markdown、code 或 raw，每个代码格还带着它上一次运行时保存下来的输出。转换器需要的全部信息就在这个结构里——notebook 自己已经知道哪部分是叙述、哪部分是代码、代码打印了什么。

有一个后果值得记牢：文件里的输出，就是保存那一刻的样子。转换器读的是保存下来的输出，它不执行任何代码。如果你改了某个格子却没重新运行，PDF 里显示的就是过期的输出。凡是打算给别人看的，转换之前先重启并全部运行。

1. 1
   Markdown 格变成排好版的正文标题、段落和列表以真实的字体层级渲染出来，所以你分析里的叙事结构会存活到 PDF 里。
2. 2
   代码格变成等宽字体块代码用等宽字体排版，并保留执行序号，所以阅读顺序和实际运行顺序一致。
3. 3
   保存的输出放在对应格子下面打印的文字和流输出直接出现在产生它们的代码下方，这个版式让 notebook 读起来像一份文档，而不是一份清单。
4. 4
   全部按 A4 分页很长的格子会跨页断开，而不是在页边被裁掉。结果会报告单元格数和页数，方便你确认没有内容被丢掉。

用浏览器打印成 PDF：在 Jupyter 里打开 notebook，用浏览器的打印对话框。零配置，而且能抓到图表。缺点是分页点落在哪算哪，经常切在格子中间，而且 Jupyter 的界面元素有时会渗进输出里。

nbconvert 转 HTML 再打印：比直接打印好，因为 HTML 里没有界面元素。要两步，但不需要 LaTeX，而且图表能忠实保留。

nbconvert 加 LaTeX：排版最好，数学记号处理正确。PDF 要进论文或学位论文时用它，并接受安装的代价。

notebook 泄露的东西比人们预想的多。输出里经常包含真实数据的样本行、报错栈里的数据库连接串、调试时粘进格子的 API 密钥，以及内部主机名。把 notebook 上传到转换服务，等于把这些一起上传了。上面的转换器在你的浏览器里运行，文件不会离开你的机器。