如何将 Jupyter Notebook (.ipynb) 文件转换为 PDF

引言

Jupyter Notebook(.ipynb)是数据科学和机器学习领域广泛使用的交互式文档格式。然而,在分享报告、提交作业或发布论文时,PDF 通常更受欢迎。本文将介绍多种将 ipynb 文件转换为 PDF 的方法,从简单快捷到高度自定义。

方法一:使用 nbconvert 命令行工具

nbconvert 是 Jupyter 自带的转换工具,支持将 .ipynb 转换为多种格式,包括 PDF。基本命令如下:

jupyter nbconvert --to pdf your_notebook.ipynb

安装依赖:需要 LaTeX 发行版(如 TeX Live 或 MiKTeX)和 Pandoc。对于 macOS 用户:brew install pandoc texlive;Ubuntu 用户:sudo apt-get install pandoc texlive-latex-extra texlive-fonts-recommended texlive-xetex。

优点:完全离线,可批量处理,保留代码和输出。
缺点:LaTeX 安装占用空间大,中文可能需要额外配置。

方法二:通过 Jupyter Notebook 界面导出

在 Jupyter Notebook 中打开文件后,点击菜单栏 File → Download as → PDF via LaTeX 或 PDF via HTML。后者不需要 LaTeX,但格式可能不完美。

优点:无需记忆命令,图形化操作。
缺点:依赖网络(如果使用HTML方法)或 LaTeX。

方法三:在线转换工具

许多网站提供免费转换服务,如 nbconvert.online、Convertio 等。只需上传 .ipynb 文件,即可下载 PDF。

优点:无需安装任何软件,快速便捷。
缺点:文件大小限制,隐私风险(不适合敏感数据)。

方法四:转换为 Markdown 再转 PDF

使用 nbconvert 先将 notebook 转为 Markdown:

jupyter nbconvert --to markdown your_notebook.ipynb

然后使用 Pandoc 或 Markdown 编辑器导出为 PDF。

解决常见问题

  • 中文乱码:确保 LaTeX 使用 XeLaTeX 引擎,并加载 ctex 宏包。可创建自定义模板。
  • 图片无法显示:检查路径或使用绝对URL。
  • 大型输出截断:在 nbconvert 配置中设置 ExecutePreprocessor.timeout 和 CellOutputs.max_text_length。

高级自定义

通过创建自定义 LaTeX 模板(.tplx 文件),可以控制页眉页脚、字体、颜色等。参考 Jupyter 官方文档。

总结

根据需求选择最适合的方法:日常快速转换建议使用 nbconvert 命令行;需要高质量排版则配置 LaTeX 模板;简单任务可在线转换。掌握这些技巧,ipynb 转 PDF 将不再是难题。