Windows命令行用NBCONVERT将Jupyter Notebook转PDF报错如何解决

第一步：修正导出无代码的命令格式 #

你当前使用的无代码导出命令存在参数拼写错误，正确格式为：

jupyter nbconvert --to pdf {你的文件}.ipynb --no-input

--no-input是完整参数名，中间不能有空格。

第二步：解决LaTeX编译报错 #

你遇到的l3backend-xetex.def相关报错是MiKTeX的LaTeX核心包版本不匹配导致的，按以下操作修复：

• 打开MiKTeX Console，切换到更新选项卡
• 点击立即检查，等待获取所有可用更新
• 选中所有待更新的包，特别是l3kernel、l3backend相关的组件，执行更新
• 更新完成后重启命令行窗口，重新执行转换命令

可选：降级nbconvert适配旧环境 #

如果更新MiKTeX后仍报错，大概率是最新版nbconvert的兼容性问题，可以安装稳定版nbconvert：

pip install nbconvert==6.5.4

补充说明 #

你看到的template_path配置警告不影响实际转换结果，是nbconvert 7.x版本修改配置项命名导致的，想要消除警告可以在命令中补充参数--template-name article即可。

如果上述方法都无效，可以先导出为tex文件再手动编译，定位具体问题：

1. 导出tex文件：jupyter nbconvert --to latex {你的文件}.ipynb --no-input
2. 手动用xelatex编译两次：xelatex {生成的tex文件名}.tex，重复执行两次解决交叉引用问题

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