<p>Sublime Text 原生 Markdown 语法不支持标题折叠,必须安装 MarkdownEditing 插件才能实现 #–###### 标题的层级折叠、gutter 图标交互及自动链接缩略等功能。</p>

Markdown 默认不支持标题折叠,别指望 Ctrl+Shift+[ 有用
Sublime Text 原生的 Markdown 语法包(Markdown.sublime-syntax)**没定义任何 foldingStartMarker 或 foldingStopMarker**,所以无论你把光标停在 # 标题 行还是空行,Ctrl+Shift+[ 都会静默失败。这不是快捷键冲突或设置问题,是语法定义里压根没写折叠规则——它被当纯文本处理。
想折标题?必须装插件,推荐 MarkdownEditing
MarkdownEditing 是目前最稳定、维护活跃的方案,它通过自定义语法和命令补全了标题层级折叠逻辑:
- 安装后,所有
#到######标题左侧 gutter 会出现 ▶ 图标,点击即可折叠/展开其后内容 - 支持设置
mde.folding.target_level:比如设为2,则所有###及更深层级标题默认收起 - 启用
mde.folding.auto_link_folding后,长链接(如[text](https://very-long-url...))会自动缩成[text][1]形式 - 注意:折叠状态只保存在当前会话,关文件就丢;大文档(>5000 行)开启后可能轻微卡顿
不用插件也能临时折一段?靠手动选区折叠
如果只是想临时藏起某几段无关内容(比如一长串 YAML front matter、测试用例或冗余说明),不需要改语法或装插件:
- 鼠标拖选目标行 → 按
Ctrl+Shift+Alt+[(Windows/Linux)或Cmd+Ctrl+Option+[(macOS) - 折叠后侧边栏出现独立三角图标,点击即展开,不影响其他结构
- 这个操作不依赖语法识别,也不修改文件,适合紧急整理或对比查看
- 但注意:重启 Sublime 后若文件已关闭,该折叠会消失
别碰那些“伪折叠”方案:region 注释、自定义正则都容易翻车
有人试图用 // region 或正则匹配 ^# 来硬加折叠,实际效果很差:
-
// region在 Markdown 中不是合法注释,会被渲染出来,且 Sublime 原生不识别这种标记 - 手动改
Markdown.sublime-syntax加foldingStartMarker:容易和插件冲突,升级后覆盖丢失,还可能破坏预览功能 - 某些老教程提的
fold_by_level对 Markdown 无效——它依赖缩进层级,而 Markdown 标题不靠缩进定义结构
真正卡住人的从来不是“怎么折”,而是误以为 Markdown 和 Python 一样天然支持折叠。先确认你用的是 MarkdownEditing 而非原生语法,再检查右下角是否显示 “Markdown Editing” 而非 “Markdown”。否则所有快捷键都在对空气按。


















