使用nbconvert时如何指定输出文件的名称与存储位置？

指定输出文件名 #

用--output（或简写-o）参数自定义输出文件的名称，无需手动添加格式后缀，nbconvert会根据你指定的输出格式自动补全：

# 将notebook.ipynb转为HTML，输出文件名为report.html
jupyter nbconvert --to html notebook.ipynb --output report

要是你硬加了后缀也能运行，但不建议这么做，避免出现格式不匹配的问题（比如指定输出PDF却加了.html后缀）。

指定存储目录 #

用--output-dir（或简写--out）参数指定输出文件的存储路径，注意如果目标目录不存在，nbconvert不会自动创建，需要提前手动创建：

# Linux/macOS先创建目录
mkdir -p ./outputs
# Windows创建目录
mkdir outputs

# 将输出文件放到./outputs目录下
jupyter nbconvert --to html notebook.ipynb --output-dir ./outputs

路径支持绝对路径和相对路径，比如绝对路径示例：

jupyter nbconvert --to pdf notebook.ipynb --output-dir /home/user/my_project/reports

同时指定文件名与目录 #

把两个参数结合起来就能同时控制输出的文件名和存储位置：

jupyter nbconvert --to pdf notebook.ipynb --output quarterly_analysis --output-dir ./docs/reports

执行后会在./docs/reports目录下生成quarterly_analysis.pdf文件。

注意事项 #

• 如果只指定目录不指定文件名，输出文件会沿用原Notebook的名称，仅替换格式后缀
• 若路径包含空格，需要用引号将路径括起来，比如：--output-dir "./my saved reports"

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