Sublime Text无法原生渲染Markdown思维导图,仅能通过markmap CLI构建系统导出SVG实现静态预览,不支持实时交互、拖拽或双击编辑。

Sublime Text 本身不支持 Markdown 思维导图渲染,也没有插件能直接把 ## 或列表结构自动转成可交互的思维导图(如 XMind、Markmap 那种树状布局)。所谓“思维导图预览”,实际只有两种可行路径:一是导出为兼容格式再用外部工具打开;二是用特定语法+插件生成 SVG/HTML 树图——但都不是 Sublime 原生能力,也不实时。
MarkdownPreview 不支持思维导图,别在设置里找 mindmap 选项
MarkdownPreview 的 parser 参数只接受 "markdown"、"github"、"mistune" 等文本转 HTML 解析器,没有 "mindmap" 或类似值。它连 Mermaid 图表都不原生支持(需额外配 enable_mermaid 且依赖 JS 渲染),更别说解析缩进列表生成层级图。你搜遍 Preferences → Package Settings → Markdown Preview → Settings 也找不到相关开关。
常见错误现象:Ctrl+Shift+P 输入 Markdown Preview 后点开空白页,或看到一堆未渲染的 - 和 + 符号——那是因为插件根本没识别你在写“导图”,只是当普通列表处理了。
- 想让列表看起来像导图?只能靠 CSS 强制缩进 + 颜色区分层级,但点击展开/折叠、拖拽、聚焦节点等功能全无
- 如果文件里混写了
```mermaid流程图,得单独开启"enable_mermaid": true并确保浏览器加载了 Mermaid JS,和思维导图无关 - 别试
toc扩展——它只生成目录锚点链接,不是可视化树图
真正能出图的方案:用 markmap CLI + Sublime 构建系统
Markmap 是目前最轻量、对 Markdown 友好的思维导图生成器,它把带缩进的列表(或 H1-H3 标题)转成可缩放的 SVG 树图。Sublime 本身不集成它,但可通过构建系统调用命令行实现一键预览:
- 先装 Node.js 和
markmap:npm install -g markmap-cli - 在 Sublime 中新建构建系统:
Tools → Build System → New Build System - 填入以下内容并保存为
Markmap.sublime-build:
{
"cmd": ["markmap", "$file", "--no-open"],
"selector": "source.gfm",
"file_regex": "^.*$",
"working_dir": "$file_path"
}
然后打开一个符合 markmap 规范的 .md 文件(例如用 # 开头做根节点,## 二级,- 列表项作子节点),按 Ctrl+B 就会在同目录生成 xxx.mm.svg。双击该 SVG 即可在浏览器查看可交互导图。
- 注意:文件必须已保存,且不能含中文路径(
markmap对 UTF-8 路径支持不稳定) - 不支持实时刷新——改完 Markdown 得再按一次
Ctrl+B,不会自动重绘 - 若报错
command not found: markmap,说明 Sublime 没读到系统 PATH,需在构建系统里写绝对路径,如"/usr/local/bin/markmap"(macOS/Linux)或"C:\Users\xxx\AppData\Roaming\npm\markmap.cmd"(Windows)
OmniMarkupPreviewer 也不能画思维导图,它只渲染基础块级元素
有人试过 OmniMarkupPreviewer 插件,以为名字带 “Previewer” 就能出图。但它本质是 MarkdownPreview 的轻量封装,后端仍走 Python-Markdown,仅支持表格、代码块、图片等常规元素。它的 Preview in Browser 命令输出的仍是线性 HTML,不会把 - A
- B
- C 自动组织成发散式节点图。
如果你看到某个教程说“装完 OmniMarkupPreviewer 就能侧边看导图”,大概率是混淆了它和 VS Code 的 Markmap 插件(后者才真调用浏览器内核实时渲染)。
- 它对图片路径敏感:相对路径如
可显示,但常 404——因为预览服务默认以当前文件为根,不模拟真实服务器路由 - 数学公式、Mermaid 都不支持,别指望它替代专门的渲染链
- 想快速验证?建个空
test.md,只写三行:# Root ## Child ### Grandchild,用 OmniMarkupPreviewer 预览——你只会看到三个标题,不会有连线或圆角框
真正卡住多数人的,不是“怎么装插件”,而是误以为 Sublime 能像 Typora 或 Obsidian 那样,在编辑器内直接拖拽节点、双击编辑、自动同步层级关系。它不能。所有“预览”都是单向转换:Markdown → HTML/SVG,改图就得回编辑器调原始文本。如果你需要频繁调整结构,不如把导图逻辑留在专用工具里,只用 Sublime 写纯文本大纲。


















