VSCode侧边栏大纲（Outline）默认不启用，需手动开启explorer.experimental.showOutline和markdown.preview.toc两项设置才能显示标题结构化导航树。
VSCode侧边栏大纲（Outline）能直接显示目录，但默认不启用
VSCode自带的“大纲”面板就是最轻量的侧边目录，但它不会自动弹出来，也不默认解析所有Markdown文件的标题结构。关键在两个设置是否打开：explorer.experimental.showOutline 和 markdown.preview.toc。
必须手动开启，否则侧边栏永远只显示“EXPLORER”“SEARCH”等常规标签，看不到标题树。
-
explorer.experimental.showOutline控制大纲是否出现在侧边栏——设为true才会出现“OUTLINE”标签 -
markdown.preview.toc决定预览窗口里是否渲染右侧浮动TOC（非侧边栏，是预览区内的小目录），它不影响侧边栏，但常被误认为是同一功能 - 仅开启
outline.automaticCollapse为false不够，没开showOutline就根本没这个面板
用 Markdown All in One 插件生成文档内可点击的 TOC 行
侧边栏大纲只是导航索引，不嵌入文档本身；如果需要把目录写进 .md 文件顶部、支持 GitHub 渲染或导出 HTML，就得生成实际的 Markdown 列表行。
Markdown All in One 是目前最稳定的选择，它不依赖 Pandoc 或外部服务，命令执行快，中文标题锚点转换也可靠（如 ## 中文标题 → [中文标题](#中文标题)）。
- 光标放在想插入的位置（通常是文件开头或
[toc]标记处），按Ctrl+Shift+P输入Markdown: Create Table of Contents - 生成的链接默认使用
github-slug规则：空格变-，中文转 URL 编码（如%E4%B8%AD%E6%96%87），标点被剔除 - 不支持自动更新——改了标题后，旧目录不会同步变，必须手动再运行一次命令
- 若想保存时自动重生成，需在插件设置里打开
markdown.extension.toc.autoUpdate
docsify 侧边栏 TOC 需要独立服务，不是 VSCode 原生能力
很多人搜“VSCode Markdown 侧边目录”，实际想要的是像 Typora 那样左边固定导航栏、右边滚动内容的效果。VSCode 做不到——它的预览是单页只读视图，没有左侧菜单区。
真要这种体验，必须起一个本地 HTTP 服务，用 docsify 动态渲染。这不是配置问题，而是架构差异：VSCode 是编辑器，docsify 是浏览器端渲染器。
-
_sidebar.md必须和index.html同级，且文件名带下划线，否则 docsify 加载失败，控制台报404 /_sidebar.md - 文档里至少要有两个
##或更高级别标题，#一级标题默认不进 TOC -
npx docsify serve .启动后访问http://localhost:3000，VSCode 只负责编辑，刷新靠浏览器自动完成 - 别试图用 Live Server 插件打开
index.html——它不加载_sidebar.md，也不执行 docsify 的 JS 初始化逻辑
中文标题锚点失效？先确认你用的是哪个渲染环境
同一个中文标题，在不同地方生成的锚点可能完全不同：VSCode 预览、GitHub、docsify、导出的 HTML，各自处理规则不一致。这不是 bug，是规范差异。
例如 ## 数据库连接配置：
- VSCode 内置预览用的是
database-connection-configuration（拼音转小写短横） - GitHub 用的是
数据库连接配置（原样 URL 编码，即%E6%95%B0%E6%8D%AE%E5%BA%93%E8%BF%9E%E6%8E%A5%E9%85%8D%E7%BD%AE） - docsify 默认用
github-slug，行为接近 VSCode，但可配成gitlab或cjk模式 - 如果你手写链接如
[跳转](#数据库连接配置)，只在 GitHub 有效；写成[跳转](#database-connection-configuration)，才在 VSCode 预览和 docsify 里生效
跨平台兼容性要求高的场景，别依赖自动生成的锚点格式，要么统一用英文标题，要么在生成后手动校验跳转目标是否真实存在。
