package control未正确安装导致markdownsidebar等大纲插件无法安装；需通过官网脚本重装并重启sublime text，再安装markdownsidebar插件，配合markdownediting语法设置与parser_timeout调优方可正常使用大纲功能。
Package Control没装好，大纲插件根本装不上
Sublime Text 本身不带大纲（Outline）功能，Markdown 大纲依赖第三方插件，但所有这类插件都必须通过 Package Control 安装——没它，后续一切白搭。很多人点 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）输 Package Control: Install Package 没反应，本质是安装失败或未重启。
验证是否就位：命令面板里能立刻列出包名、输入后不卡顿、无报错才算成功。如果控制台执行过安装脚本但没彻底退出 Sublime 再重开，Package Control 就不会注册进命令系统。
- 别信菜单里 “Preferences → Install Package Control” —— Sublime Text 4 已移除该入口
- 必须用官网最新 Python 3 脚本（packagecontrol.io/installation），在
Ctrl+`控制台一次性粘贴回车 - 控制台出现
Package Control: Installed 1 package后，关掉所有 Sublime 窗口，再重新打开
要装的是 MarkdownSidebar，不是 MarkdownOutline 或 Outline
搜索 “Markdown 大纲” 容易装错：比如 MarkdownOutline 已多年未更新，不兼容 ST4；Outline 是通用代码大纲插件，对 Markdown 支持极弱，基本不识别标题层级。真正稳定可用的是 MarkdownSidebar，它专为 Markdown 设计，实时生成可折叠的标题树，支持跳转、拖拽排序、双击定位光标。
- 安装方式统一：
Ctrl+Shift+P→Package Control: Install Package→ 输入MarkdownSidebar（注意拼写，末尾是bar，不是outline） - 装完无需重启，但需确保当前文件语法设为
Markdown GFM（右下角点语言名 →MarkdownEditing→Markdown GFM） - 默认快捷键是
Ctrl+K Ctrl+O（Windows/Linux）或Cmd+K Cmd+O（macOS），也可在Preferences → Key Bindings里自定义
大纲不显示？检查 MarkdownEditing 和文件后缀绑定
MarkdownSidebar 不自己管语法高亮，它依赖 MarkdownEditing 提供的解析能力。如果 .md 文件打开还是 Plain Text，大纲面板就完全空白——不是插件坏了，是 Sublime 根本没把这文件当 Markdown 解析。
- 手动设置一次：打开任意
.md文件 → 右下角点当前语法名 → 选MarkdownEditing→Markdown GFM - 永久生效：点菜单
View → Set Syntax → Open all with current extension as...→ 再选Markdown GFM - 如果仍不显示，检查
Preferences → Package Settings → MarkdownSidebar → Settings – User，确认没有误加"enabled": false这类禁用项
大纲刷新延迟或跳转不准，调低 parser_timeout
长文档（尤其含大量代码块、数学公式）可能导致大纲解析超时，表现为点击标题不动、折叠状态不同步、或右侧预览滚动错位。这不是 bug，是默认解析器的 timeout 值太保守。
- 打开
Preferences → Package Settings → MarkdownSidebar → Settings – User - 加入这一行：
"parser_timeout": 3.0（单位秒，原默认是 1.0） - 如果文档含
$$公式或 Mermaid 图，建议同时确保已装MarkdownPreview并启用enable_mathjax，否则MarkdownSidebar会跳过这些区块导致层级计算偏差
大纲功能强弱取决于 Markdown 解析质量，而解析质量又绑在 MarkdownEditing + MarkdownPreview 组合上——单独装 MarkdownSidebar 就像只装方向盘不装发动机。
