VSCode侧边栏大纲不显示标题需依次确认：文件语言模式为Markdown、标题行语法规范（#开头无空格）、位于当前工作区目录内、编码为UTF-8；Docs View插件仅索引工作区内已打开文件，Markdown All in One的TOC与大纲逻辑独立。
VSCode 侧边栏大纲不显示标题？检查语言模式和层级语法
VSCode 原生支持大纲（Outline）视图，但不会自动识别所有文本为 Markdown 结构。必须确保当前文件被正确识别为 markdown 语言模式——右下角状态栏应显示“Markdown”，若显示“Plain Text”或“Auto Detected”，需点击手动切换。
大纲只解析以 # 开头的标题行，且要求前后无空格、无多余字符（如 ## 二级标题 末尾空格会导致不识别）。不支持缩进式标题（如 ## 标题）或括号包裹式（##(标题)）。
- 验证方式：按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，在 Console 中输入vscode.workspace.textDocuments.find(d => d.fileName.endsWith('.md'))?.languageId，返回值应为"markdown" - 常见失效场景：文件未保存（.md 后缀但内容为空）、标题行混用全角符号、使用了插件自定义的非标准标题语法（如某些 TOC 插件扩展的
### [title]）
Docs View 插件大纲不更新？别忽略工作区加载范围
Docs View 是目前最轻量可靠的大纲侧边栏插件，但它依赖 VSCode 的符号提供机制，仅扫描**已打开且属于当前工作区**的文件。如果你把 .md 文件放在工作区根目录之外（比如桌面或 D:\notes），它不会出现在大纲中。
另外，该插件默认不索引代码块内的标题（如
# 内嵌标题
），也不解析 Front Matter 区域（--- 包裹的 YAML 头）里的标题字段。
- 解决路径问题：用
File > Add Folder to Workspace显式将文档所在目录加入工作区，而非直接双击打开单个文件 - 避免干扰：禁用其他大纲类插件（如
Markdown Outline），它们可能注册冲突的符号提供器，导致Docs View数据源被覆盖 - 刷新触发：修改标题后，大纲不会实时响应，需手动保存文件（
Ctrl+S）或切换标签页再切回
Markdown All in One 的 TOC 生成和大纲不同步？这是设计使然
Markdown All in One 的 Create Table of Contents 命令生成的是文档内嵌的 [TOC] 或手动列表，它和侧边栏大纲（Outline）走的是两套逻辑：前者纯文本扫描，后者依赖 VSCode 的 Language Server 符号提取。因此会出现“大纲里有标题，TOC 里没生成”或反之的情况。
典型差异点：Markdown All in One 默认跳过以 ## 开头但后面紧跟 HTML 注释（如 ## 标题 <!-- ignore -->）的行；而大纲视图只要语法合法就收录。
- 强制同步方法：在设置中启用
markdown.extension.toc.omitHeadingLevel并设为空数组，避免某级标题被过滤 - 注意性能：对超长文档（>5000 行），
Markdown All in One的 TOC 生成可能卡顿，此时建议改用原生大纲 +Docs View，更稳定 - 导出影响：用该插件导出 HTML/PDF 时，生成的 TOC 是独立渲染的，和侧边栏大纲无关，别指望预览窗口里的导航能跳转到编辑器对应位置
大纲里出现乱码或缺失中文标题？查字体与编码设置
中文标题在大纲中显示为方块或空白，大概率不是插件问题，而是 VSCode 渲染字体未覆盖 CJK 字符集。大纲视图复用编辑器字体设置，但部分主题或自定义 CSS 会覆盖其 font-family，导致符号无法正常绘制。
另一个隐蔽原因是文件编码：如果 .md 文件用 GBK 保存，而 VSCode 以 UTF-8 解析，标题行可能被截断或乱码，进而无法被符号提取器识别。
- 快速验证：打开命令面板（
Ctrl+Shift+P），运行Developer: Inspect Editor Tokens and Scopes，把光标停在标题上，看右侧是否显示entity.name.section.markdown—— 没有则说明语法层未识别 - 修复字体：在
settings.json中添加"editor.fontFamily": "'Microsoft YaHei', 'Noto Sans CJK SC', Consolas"，确保中文字体在前 - 统一编码：右下角点击编码标识（如
UTF-8），选Reopen with Encoding > UTF-8，再保存一次文件
大纲功能看似简单，实际是语言模式、符号提取、字体渲染、工作区边界四层机制叠加的结果。任一环节松动，都会导致标题“看不见”。与其反复重装插件，不如先确认文件是否真正以 Markdown 模式加载、路径是否在工作区内、编码是否为 UTF-8——这三个点卡住，后面所有增强都白搭。
