VS Code Jupyter Notebook大纲显示所有Markdown块的原因及调整方法

问题成因 #

VS Code 内置Jupyter扩展的大纲（TOC）默认配置会将所有独立Markdown单元格都纳入大纲展示范围，不会默认过滤非标题类的Markdown内容，因此会出现所有Markdown块都出现在目录里的情况。

仅展示各级标题的配置方法 #

方法1：大纲面板快速设置 #

• 打开目标Jupyter Notebook文件，调出左侧大纲面板
• 点击面板顶部的漏斗形筛选按钮
• 在弹出的筛选菜单中，取消勾选Markdown 单元格选项，大纲就会仅展示带#/##等标记的各级标题，设置即时生效。

方法2：修改配置项永久生效 #

• 打开VS Code设置界面：使用快捷键Ctrl+,（Windows/Linux系统）或Cmd+,（Mac系统）
• 在设置顶部搜索框输入notebook.outline.showMarkdownCells
• 取消该配置项的勾选即可；也可以直接打开settings.json配置文件，添加如下配置行：

"notebook.outline.showMarkdownCells": false

如果只想让该配置对当前项目生效，把上述配置写入当前工作区下的.vscode/settings.json文件即可，不会影响全局配置。

类JupyterLab的大纲显示切换支持 #

目前VS Code的Jupyter扩展已经支持自定义大纲展示内容，和JupyterLab的大纲切换能力对齐，可在大纲筛选菜单中自主勾选需要展示的条目类型：

• 显示/隐藏各级Markdown标题
• 显示/隐藏普通Markdown单元格
• 显示/隐藏代码单元格
• 支持按单元格标签做自定义筛选

内容的提问来源于stack exchange，提问作者Dince-afk