vscode需通过markmap插件实现markdown思维导图预览，其为只读视图，依赖严格标题层级（#→##→###连续嵌套），不支持编辑、拖拽或导出可编辑格式，常见问题包括插件未激活、文件后缀非.md、其他markdown插件冲突及autofit导致缩放异常。
VSCode 本身不内置 Markdown 思维导图功能，但通过 markmap 插件可直接在编辑器内实时渲染出交互式思维导图——它不是“画图工具”，而是把你的 .md 文件按标题层级自动转成只读视图，边写边看，无需切换窗口。
为什么 markmap 预览打不开？检查这三点
常见现象：装了插件，打开 .md 文件，右上角没出现黄色脑图图标；或点了没反应；或命令面板搜不到 Markmap: Open Preview。
- 文件后缀必须是
.md——.txt、.markdown、.km均不识别 - 插件未正确激活：重启 VSCode 后再试；若仍无效，用命令面板
Ctrl+P输入ext install gera2ld.markmap-vscode手动重装 - 冲突插件干扰：禁用其他 Markdown 渲染类插件（如
Markdown Preview Enhanced），尤其当它们也监听.md文件时
怎么让 # 标题正确变成中心节点？注意层级连续性
markmap 严格依赖 Markdown 标题的嵌套逻辑。它把第一个 # 当作根节点，后续层级必须逐级递进，跳级会导致子节点挂错位置，结构完全错乱。
Markdown Converter 1.0.0
下载
使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。
- ✅ 正确写法：
# 中心主题→## 一级分支→### 二级子项 - ❌ 错误写法：
# 中心主题→### 直接三级（中间缺##，该节点会被当作根的同级，而非子节点） - ⚠️ 列表也支持：
- 一级分支和- 二级子项（缩进两个空格）效果等同于##/###，但不如标题直观，调试困难时优先用标题
预览里点不动、拖不了？这不是 bug，是设计如此
你点开预览后尝试拖拽节点、双击编辑、新增分支——全都会失败。这不是插件坏了，而是 markmap 的定位就是「文本驱动的只读视图」。
- 所有修改必须回到
.md源文件中进行：增删标题、调整缩进、改文字，保存后预览自动刷新 - 不支持导出可编辑的
.xmind或.km，导出的 HTML 是静态页面，无交互逻辑 - 如果需要真正“画”脑图（拖拽/增删/自由布局），应换用
vscode-mindmap（支持.km）或Draw.io Integration（支持.drawio）
最容易被忽略的一点：预览窗格默认启用 markmap.autoFit，大型文档一打开就缩到看不见细节。关掉它，才能手动缩放和拖动查看局部——这个开关藏在设置里搜 markmap.autoFit 就能找到。
