以下为基于Mermaid语法绘制思维导图的详细指南,整合了最新版本(截至2025年)的核心语法与进阶技巧:
一、基础语法结构
mindmap
root((中心主题))
分支1
子节点1
子节点1.1
三级节点1
分支2
子节点2
子节点2.1
-
根节点定义
• 使用root(( ))
包裹中心主题,双括号表示圆形节点
• 支持多行文本(例如root((主题A<br>主题B))
) -
层级构建规则
• 缩进方式:每级缩进2个空格或1个Tab
• 自动布局:子节点默认以放射状排列,支持手动调整方向(如direction LR
)
二、进阶功能扩展
1. 节点样式定制
mindmap
root[方形中心主题]
branch1(圆角分支)
sub1[[凸起样式]]
sub2>旗帜样式]
branch2{菱形分支}
sub3((圆形节点))
sub4{
{六边形}}
• 形状符号:
[ ]
方形、( )
圆角、{ }
菱形、(( ))
圆形、> ]
右向旗帜
• 颜色标注:
使用style 节点ID fill:#色值,stroke:#边框色
(如style branch1 fill:#FF9999
)
2. 图标与注释
mindmap
root((AI技术))
机器学习::icon(fa fa-microchip)
深度学习
神经网络::icon(fa fa-project-diagram)
• 图标嵌入:通过::icon(fa fa-xxx)
调用FontAwesome图标库
• 注释添加:
%% 注释内容
(生成时自动隐藏)
三、复杂结构示例
mindmap
root((项目规划))
需求分析
用户调研
问卷设计
数据分析
竞品分析
技术选型
前端框架
React::icon(fa fa-react)
Vue
后端架构
微服务
单体应用
风险管理
风险识别
应对策略
核心要点说明:
- 多级嵌套:支持无限层级延伸(建议不超过5层以保持可读性)
- 混合样式:同一导图中可组合不同形状与图标
- 自动排版:节点数量过多时自动调整布局密度
四、工具适配与优化
-
主流平台支持:
• Obsidian:通过代码块直接渲染,支持实时预览
• Notion:需粘贴Mermaid代码至代码块
• Typora:原生支持.md
文件渲染 -
性能优化建议:
• 单图节点数控制在200个以内
• 复杂导图拆分多个子图(用subgraph
模块)
• 避免使用过多实心填充色(影响渲染速度)
五、常见问题解决
- 特殊字符处理:
节点内容含