Markdown Mindmap · 黑白脑图

A local Markdown mind map viewer for VS Code.

VS Code 本地 Markdown 脑图预览扩展。以一级标题作为中心主题、嵌套列表作为分支，使用黑白主题与圆角折线展示内容。

安装

要求 VS Code 1.85.0 或更新版本。在扩展视图的“…”菜单选择“从 VSIX 安装…”，安装 processon-markdown-mindmap-0.1.13.vsix。升级后执行 Developer: Reload Window。

也可以通过命令行安装：

code --install-extension ./processon-markdown-mindmap-0.1.13.vsix

使用

打开 .md 或 .markdown 文件，在编辑器类型切换菜单（Reopen Editor With）中选择 ProcessOn 脑图。

.md 文件也支持编辑器右上角的层级图标、文件右键菜单或命令面板 Markdown 脑图：打开预览，打开并排预览。通用示例见 examples/mindmap.md。

• 点击节点旁圆圈折叠或展开，数字表示隐藏的后代节点总数。
• 拖动空白画布平移，滚轮围绕鼠标位置快速缩放。
• “＋”按 1.2 倍放大，“−”按其倒数缩小；“标准大小”恢复 100%；“适应画布”居中显示所有可见分支。
• “展开”展开全部节点；“收起”折叠较深分支。
• 点击备注图标查看备注；双击节点或点击“定位 Markdown”，在预览所在编辑器分组的新标签页中打开原文并定位到对应行，不创建分屏。若同一分组已有原文标签页则直接复用。
• 节点边框、焦点框、按钮、输入框及备注面板统一使用圆角；不显示悬浮 Tips，鼠标悬停不产生节点边框或底色变化。
• 修改原文会实时更新脑图，折叠状态按文件分别持久保存，关闭标签页或重启 VS Code 后重新打开，会恢复上次的展开/收起状态。全展开状态也会保存。

顶部仅显示当前文件名及操作按钮。

主题与布局

所有文档使用同一通用黑白主题：中心主题 20px、黑底浅色字，主分支 14px、浅灰底，子节点 12px；连线为 2px 黑色圆角折线。主题参数位于 media/theme.js。

按文档顺序将主分支分配到左右两侧，不根据标题、节点名称或文件路径选择样式。首次打开默认折叠第三层及更深的非叶节点；有已保存的折叠状态时优先恢复。状态保存在当前 VS Code 用户配置的扩展全局存储中，不修改 Markdown。文件身份按完整 URI 区分，文件改名或移动后视为新文件；节点按文本路径匹配，改名或移动的节点可能需要重新设置折叠状态。

支持范围

支持一级标题、嵌套无序/有序列表、多行节点和引用块备注。节点内 Markdown 显示为纯文本；嵌套列表内容会成为分支。不加载远程图片，也不执行原文 HTML。内容编辑在文本编辑器中完成。

渲染器独立实现，运行时无需登录或访问 ProcessOn。不包含特定文档的节点数据、样式匹配表或个人笔记。字体及布局算法可能导致不同系统上的显示差异；不支持自由浮动主题、关联线和图形编辑。

开发与验证

建议 Node.js 20.19 或更新的 LTS 版本，首次安装开发依赖需要网络：

npm ci
npm test
npm run package

可选浏览器验证：node test/visual.cjs。默认使用 macOS 标准安装路径的 Google Chrome。测试仅使用通用示例，覆盖布局、折叠、备注、原文更新、滚轮缩放及 100% 恢复；截图输出为 preview.png。

扩展标识与卸载

扩展标识：niean.processon-markdown-mindmap。自定义编辑器类型：processonMindmap.editor。命令：processonMindmap.open。

code --list-extensions --show-versions
code --uninstall-extension niean.processon-markdown-mindmap

MIT 许可证见 LICENSE。VS Code Webview 接口参考：https://code.visualstudio.com/api/extension-guides/webview

隐私

不收集遥测，不发送笔记内容。折叠状态保存在 VS Code 扩展全局存储中。详情见随包提供的 PRIVACY.md。