vscode默认不支持toc侧边栏预览，其内置markdown preview仅渲染正文；需借助docsify等外部工具实现，推荐用docsify+live server搭建本地toc服务，轻量实时且无需构建。
VSCode默认不支持TOC侧边栏预览
VSCode自带的Markdown Preview只渲染正文，不生成或显示目录树。你点“预览”看到的永远是纯内容滚动页，Ctrl+Shift+P搜“Open Preview”也一样——这是设计使然，不是配置没开对。
要真有侧边TOC，必须引入外部工具链，核心思路是：用一个能解析##、###并生成锚点链接的静态站点生成器（比如docsify或mkdocs），再让VSCode打开它的本地服务页面。
推荐方案：用docsify + live server快速起本地TOC页
docsify轻量、零构建、支持实时刷新，且默认启用TOC（只要文档里有二级以上标题）。它不改原始.md文件，只是在浏览器里动态渲染。
实操步骤：
- 在你的Markdown项目根目录下运行：
npm init docsify-cli@latest（需已装Node.js） - 按提示初始化后，确保
_sidebar.md存在（可为空），并在index.html中确认loadSidebar: true - 启动服务：
npx docsify serve .，访问http://localhost:3000 - 在VSCode里用
Live Server插件右键打开index.html也能生效，但端口可能冲突，优先用docsify serve
注意：docsify读的是当前目录下的README.md或指定入口，不是VSCode当前打开的单个文件——所以得把想预览的文档放在项目结构里，而不是随便双击一个孤立.md。
别踩坑：TOC不显示的三个高频原因
常见现象：页面加载了，左侧空白，或者只有“SUMMARY”文字没内容。
-
_sidebar.md路径不对——它必须和index.html同级，且文件名带下划线 - 文档里没用
##或###，只用#（一级标题不进TOC）或纯文本加粗（**text**不算标题） - 用了
markdown-it-toc-and-anchor等插件但没在index.html里正确require，或版本不兼容docsify 4.x
验证方法：打开浏览器开发者工具，看Console有没有Failed to load resource报_sidebar.md 404，或Network里_sidebar.md返回空内容。
替代方案对比：mkdocs vs typora vs VSCode插件
mkdocs生成静态HTML，TOC稳定但每次改完要mkdocs serve重编译，延迟明显；Typora有原生TOC侧边栏，但它是独立编辑器，不是VSCode插件；VSCode里搜到的Markdown All in One或Markdown Preview Enhanced，前者只加快捷键不加侧边栏，后者虽支持TOC但依赖Pandoc且常与新VSCode版本冲突，启动慢、热更新卡顿。
所以如果你非要留在VSCode界面里操作，又想要可靠TOC，最简路径仍是：用docsify搭个最小服务，然后把VSCode当成纯编辑器用——改完保存，浏览器自动刷新，左侧TOC跟着动。
真正麻烦的不是启动，而是第一次配好后忘记_sidebar.md得手动维护层级，或者误删index.html里的loadSidebar: true——这种细节不报错，只静默失效。
