nbconvert 是一个用于转换和执行 Jupyter Notebook 的开源工具。它已随 Jupyter Notebook 安装(它在内部用于在 Web 用户界面中将 .ipynb 文件转换为其他格式)。nbconvert 提供 Python API 和命令行工具。只需运行以下命令即可查看帮助消息:
jupyter nbconvert
执行笔记本并用最新的计算覆盖现有的笔记本:
jupyter nbconvert --execute --to notebook --inplace mynotebook.ipynb
执行 mynotebook.ipynb 并将最新版本保存在其他 .ipynb 文件中,请使用以下命令:
jupyter nbconvert --execute --to notebook mynotebook.ipynb
>> [NbConvertApp] Converting notebook mynotebook.ipynb to notebook
>> [NbConvertApp] Writing 2538 bytes to mynotebook.nbconvert.ipynb
它将执行的笔记本保存到 mynotebook.nbconvert.ipynb
文件中。您可以指定自定义输出名称和自定义输出目录:
jupyter nbconvert --execute --to notebook --output custom-name --output-dir /custom/path/ your-notebook.ipynb
生成的笔记本将保存到 /custom/path/
处的 custom-name.ipynb
文件中。请注意,在命令行中,–output 参数中没有文件扩展名(只有 custom-name
,而不是 custom-name.ipynb
)。
--allow-errors
: 使用此标志,所有单元格都将被执行,即使其中一个单元格出现错误。默认行为是在第一次出现错误后停止执行并且不创建输出笔记本。即使出现错误也会执行笔记本的示例命令:
jupyter nbconvert --execute --to notebook --allow-errors your-notebook.ipynb
执行笔记本并将输出保存为 HTML 格式。此外,您还可以在最终笔记本中隐藏代码。示例命令将执行笔记本并将其保存为隐藏代码的 HTML 文件。
jupyter nbconvert --execute --to html --no-input your-notebook.ipynb
>> [NbConvertApp] Converting notebook your-notebook.ipynb to html
>> [NbConvertApp] Writing 576249 bytes to your-notebook.html