Jupyter Notebook下载异常：nbconvert报错‘escape_html_keep_quotes’不存在

安全阿岳

2026-8-18

解决方案：修复Jupyter Notebook nbconvert的"escape_html_keep_quotes"过滤器错误

卸载MikTeX、Pandoc后，nbconvert的配置文件或残留模板里还保留了对escape_html_keep_quotes这个自定义过滤器的引用，导致所有下载操作触发nbconvert时找不到该过滤器报错。

清理残留的nbconvert配置
- 打开终端，执行命令找到Jupyter配置目录：
```
jupyter --config-dir
```
- 进入该目录，找到jupyter_nbconvert_config.py或nbconvert_config.py文件，用文本编辑器打开。
- 搜索escape_html_keep_quotes，删除所有包含这个过滤器的配置行（比如添加过滤器的c.Exporter.filters相关代码），保存文件后关闭。
检查并删除残留模板
- 执行命令找到nbconvert的安装路径：
```
python -c "import nbconvert; print(nbconvert.__path__)"
```
- 进入路径下的templates文件夹，删除你之前手动添加的所有自定义模板文件/文件夹。
- 同时检查Jupyter配置目录下的templates文件夹，同样删除残留的自定义模板。
重装nbconvert修复损坏文件
如果上述两步没解决问题，大概率是nbconvert的核心文件被之前的模板修改损坏：
- 卸载nbconvert：
```
pip uninstall -y nbconvert
```
- 重新安装匹配版本的nbconvert：
```
pip install nbconvert
```
- 如果你用conda环境，替换成：
```
conda remove nbconvert && conda install nbconvert
```
测试验证
关闭所有Jupyter进程，重新启动Notebook，尝试"下载为"任意格式，确认报错消失。