主要观点:在使用 Jupyter Notebook 时,常需将其作为除 notebook 文件外的其他形式分发,最可能是为给非技术用户分享内容,nbconvert 是内置工具可将 notebook 导出为多种格式,如 html、latex、pdf 等,其使用 jinja 模板,依赖 pandoc 和 tex,还可批量转换多个 notebook 及创建配置脚本,转换时可使用-execute
标志执行 notebook 代码,也可创建 Python 脚本编程执行 notebook,nbconvert 有很多配置选项可自定义。
关键信息:
- 常用导出格式及命令:
jupyter nbconvert notebook.ipynb --to format
(format 可为多种格式) - 批量转换命令:
jupyter nbconvert notebook*.ipynb --to format
或jupyter nbconvert notebook1.ipynb notebook2.ipynb --to format
- 执行 notebook 命令:
jupyter nbconvert --execute my_notebook.ipynb --to pdf
- Python 脚本执行 notebook 代码示例
- 可通过readthedocs了解更多信息
重要细节:
- nbconvert 用 jinja 模板将
.ipynb
文件转换为其他静态格式 - 转换为 restructuredtext 或 latex 时需安装 pandoc
- 转换为 html 有 full 和 basic 两种模式
- 执行 notebook 时代码不能有错误,否则转换失败
- 可通过documentation here了解配置选项
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。