如何阻止Jupyter Lab目录（TOC）中显示锚标签？

算力阿峰

2026-6-23

问题描述

我的Jupyter Lab目录（TOC）原本不会渲染显示Markdown标题中的锚标签代码，例如在笔记本的Markdown单元格中写：

# Parentheses <a id="parentheses"></a>

之前目录只显示「Parentheses」作为H1标题，但现在锚标签<a id="parentheses"></a>会直接在目录里显示出来。尝试调整Jupyter Lab设置、切换环境都没解决，查官方文档也没找到相关说明。切换到旧版本conda环境启动Jupyter Lab则恢复正常，推测是某次conda更新导致目录的Markdown渲染逻辑变化，但不确定具体是哪个模块引发的问题。

排查与解决建议

锁定Jupyter Lab核心版本：对比新旧环境的jupyterlab版本，优先回退到旧环境中正常的版本，执行：
```
conda install jupyterlab=旧版本号
```
验证是否恢复正常，确认是否是jupyterlab本身的版本更新导致的问题。
检查TOC扩展版本：Jupyter Lab的目录功能依赖@jupyterlab/toc扩展，查看新旧环境中该扩展的版本差异，尝试回退该扩展版本：
```
jupyter labextension install @jupyterlab/toc@旧版本号
```
排查依赖链变化：用conda list导出新旧环境的完整依赖列表，重点关注和Markdown渲染、TOC相关的包（如markdown-it-py、jupyterlab-markdown等），逐个回退可疑包版本测试。
禁用第三方扩展排查冲突：临时禁用所有非官方扩展，重启Jupyter Lab后观察问题是否消失：
```
jupyter labextension disable --all
```
若恢复正常，再逐个启用扩展排查冲突源。