sublime text 原生 markdown 语法不支持标题折叠，必须安装 markdownediting 插件才能实现 #–###### 标题的层级折叠、gutter 图标交互及自动链接缩略等功能。

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、测试用例或冗余说明），不需要改语法或装插件：

Markdown Canvas

将Markdown文件转换为美观的HTML页面，适用于Canvas或浏览器查看。用于用户请求渲染、可视化、显示或分享Markdown文件时。

下载

• 鼠标拖选目标行 → 按 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”。否则所有快捷键都在对空气按。