vscode侧边大纲不显示需检查三项：启用explorer: show outline、设置"markdown.preview.toc": true和"explorer.experimental.showoutline": true、确保文件为已保存的.md且语言模式为markdown。
VSCode 侧边大纲（Outline）不显示？检查这三项设置
VSCode 原生就支持 Markdown 目录结构解析，但大纲面板默认可能被关闭或未正确启用。不是必须装插件才能看到目录，先确认基础能力是否激活：
- 按
Ctrl + ,打开设置，搜索outline，勾选Explorer: Show Outline - 在
settings.json中确保有这两行："markdown.preview.toc": true"explorer.experimental.showOutline": true - 打开的文件必须是
.md后缀，且语言模式设为Markdown（右下角状态栏确认，不是Plain Text）
常见错误：改了设置没重启编辑器，或文件没保存——大纲只对已保存的 Markdown 文件生效。
想在文档里插入可点击的 TOC 块？用 Markdown All in One 的命令
侧边大纲只是导航视图，真正要生成一个嵌入文档顶部、带锚点链接的 TOC 区域，得靠插件。最稳定的是 Markdown All in One：
- 安装后，打开
.md文件，按Ctrl + Shift + P - 输入
Markdown: Create Table of Contents并回车 - 它会在光标处插入类似这样的内容：
- [简介](#简介)- [安装步骤](#安装步骤)
注意：生成的链接 ID 是基于标题文本自动转义的（比如 ## 安装步骤 → #安装步骤），中文标题没问题，但含特殊符号（如 /、?）时可能跳转失败，建议标题尽量简洁。
Auto Markdown TOC 的 [TOC] 标记为什么没反应？
这个插件依赖显式标记触发更新，不是监听保存事件。如果你写了 [TOC] 却没生成内容，原因通常是：
- 标记必须独占一行，前后不能有空格或文字：
✅ 正确：[TOC]
❌ 错误：## 目录 [TOC]或[TOC] - 需要手动运行命令：
Auto Markdown TOC: Update TOC（同样通过Ctrl + Shift + P调用） - 插件默认只处理
#到######，如果文档里混用了 HTML 标题（如<h2></h2>），它会直接忽略
它比 Markdown All in One 更轻量，适合大型文档中需要精确控制 TOC 范围的场景，比如跳过某些章节——加 <!-- omit in toc --> 注释即可。
标题修改后 TOC 没自动更新？别指望“全自动”
目前没有任何 VSCode 插件能真正做到“保存即刷新 TOC 块”，所谓自动更新，其实是指重新运行生成命令。这是设计使然，不是 bug：
-
Markdown All in One提供Markdown: Update Table of Contents命令，快捷键是Ctrl + Shift + P→ 输入该命令 - 部分用户误配了
markdown.extension.toc.updateOnSave，但该配置项在新版插件中已被移除，继续写进settings.json无效 - 如果频繁增删标题，建议把生成/更新 TOC 的命令绑定到自定义快捷键，比如
Ctrl + Alt + T
真正的坑在于：很多人以为插件会监听标题变化并实时重写 TOC 块，结果改完标题忘了手动更新，导致链接失效。记住——TOC 是快照，不是活引用。
