含Markdown单元格的Jupyter Notebook导出PDF失败求助

核心原因 #

虚拟环境（venv）未正确识别系统安装的Pandoc和XeLaTeX路径，导致导出Markdown时触发的转LaTeX流程依赖缺失；纯代码单元格导出无需经过Markdown转译环节，因此不受影响。

解决方案 #

1. 确认系统级工具路径有效性 #

• 终端执行which xelatex，正常返回应为/Library/TeX/texbin/xelatex，验证MacTeX的XeLaTeX可全局调用
• 终端执行which pandoc，若为系统安装版本，路径通常是/usr/local/bin/pandoc或/opt/homebrew/bin/pandoc；若仅存在虚拟环境内的pip安装版本，需后续替换

2. 配置VSCode终端加载全局环境变量 #

VSCode集成终端可能未自动加载系统全局PATH，需手动配置：

• 打开VSCode设置（快捷键Cmd+,），搜索terminal.integrated.env.osx
• 点击「编辑 in settings.json」，添加如下配置：

"terminal.integrated.env.osx": {
    "PATH": "/Library/TeX/texbin:/usr/local/bin:$PATH"
}

• 重启VSCode使设置生效

3. 替换虚拟环境Pandoc为系统版本 #

pip安装的Pandoc（2.4版本偏旧）易出现兼容性问题，建议改用系统级版本：

• 卸载虚拟环境内的pandoc：pip uninstall pandoc
• 检查系统Pandoc版本：pandoc --version，若版本低于2.10，用Homebrew升级：brew install pandoc（未装Homebrew需先安装）

4. 验证导出流程 #

打开含Markdown单元格的Jupyter Notebook，点击右上角「导出」→「PDF via LaTeX」；若仍报错，查看VSCode「输出」面板（选择「Jupyter」频道），根据具体路径错误调整PATH配置。

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