语法详解

用 Markdown 画思维导图:markmap 等工具入门

你写的 Markdown 列表,本身就是一棵“树”。用 markmap 这类工具,能把缩进列表一键变成可折叠、可缩放的思维导图,做读书笔记和知识梳理特别顺手。

一、为什么 Markdown 适合画脑图

思维导图的本质就是“层级结构”,而 Markdown 的无序列表 + 缩进天生就是层级结构。你不需要拖拽节点,只要用 - 和空格表达从属关系,工具就能自动排版成树状图。

好处很明显:纯文本、可版本化、能 diff、方便和笔记打通。这正是 Markdown 做笔记与知识管理 的延伸。

二、markmap 是什么

markmap 是最流行的“Markdown 转思维导图”开源工具,提供 VS Code 插件、在线编辑器、命令行(markmap-cli)三种用法。它读取你的 .md,输出一个可缩放、可折叠节点的交互式网页脑图。

  • 在线版:打开 markmap 官网,粘贴 Markdown 即可看效果,零安装。
  • VS Code 插件:装 “Markmap Preview”,右侧实时预览脑图。
  • 命令行:npx markmap-cli 你的文件.md 生成 HTML。

三、怎么写一份脑图源文件

就是平时写列表,用缩进表达层级。下面这份 Markdown 会渲染成一张脑图:

# 我的知识框架
## 输入
- 阅读
  - 书
  - 论文
- 听课
## 加工
- 卡片笔记
- 思维导图
## 输出
- 博客
- 文档

规则很简单:# 是一级主题,## 是分支,- 嵌套越多越深。想加粗、加链接也行,markmap 会保留。

小技巧:在 365Lab 编辑器 里先把列表写顺、确认缩进层级,再贴到 markmap,几乎零试错。

四、思维导图 vs 流程图怎么选

两者都靠“语言标注的代码块”实现,但表达意图不同:

  • 思维导图:表达“分类与从属”,适合梳理概念、做大纲、记笔记(本文)。
  • 流程图/时序图:表达“步骤与流向”,适合讲流程、算法、时序,详见 用 Mermaid 画流程图。
维度思维导图(markmap)流程图(Mermaid)
表达重点层级/分类步骤/流向
源格式缩进列表图语法(graph/seq)
典型用途大纲/笔记/脑暴流程/时序/架构

五、导出与分享

markmap 生成的脑图是 HTML,可直接打开或嵌入网页;也能导出 PNG/SVG 当配图。需要放进 PPT 时,参考 用 Markdown 做 PPT 的嵌入思路。

六、常见问题

Q:和 Mermaid 冲突吗?
A:不冲突。markmap 专门吃列表生成脑图,Mermaid 吃图语法生成流程图,二者可以同一篇文档里并存。

Q:中文显示正常吗?
A:正常。markmap 默认字体支持中文,粘贴中文列表即可。

Q:能协作编辑吗?
A:源文件就是 .md,放仓库里配合 团队协作 就能多人维护。

Q:和代码块语法有关系吗?
A:markmap 也常以“语言标注为 markmap 的代码块”形式出现,底层机制和 Markdown 代码块 一致。


先把列表语法练熟,看 Markdown 语法速查表;要做流程类图,看 用 Mermaid 画流程图;从 Markdown 入门 系统学起更稳。

先把列表写顺,再生成脑图

用 365Lab 在线编辑器把层级列表写清楚、预览满意,再贴进 markmap,脑图一次成型。免注册、内容本地保存。

免费开始写作 →