用途:Mermaid 是基于文本的绘图工具,用类 Markdown 语法渲染图表。对研究者而言,它把图表源码化,可纳入版本控制,并在 GitHub、GitLab、Notion、Obsidian 等文档平台即时渲染。与 draw.io、Lucidchart 等图形工具不同,图表以纯文本保存在文档中,便于随代码和论文一同维护,适合研究文档、README、方法部分的软件架构图及图形摘要。
主要图表类型:流程图画算法、实验步骤和数据处理流程,节点形状含矩形(处理)、圆角(起止)、菱形(判断)、六边形、平行四边形、圆形、体育场形,方向可用 TD/TB、BT、LR、RL,支持 subgraph 分组与 style 着色。时序图描述组件随时间的交互,适合 API 调用与协议步骤,支持 participant、Note、loop、同步箭头 ->>、返回虚线箭头 -->>、失败消息 -x。类图记录代码架构与数据模型,支持属性、方法、多重度与依赖关系。甘特图用于项目时间线与研究计划,支持 dateFormat、axisFormat、section、done/active、milestone 与 after 依赖。状态图建模实体生命周期,如投稿到发表的状态流转。
使用方式:在 Markdown 中用 ```mermaid 代码块包裹即可在 GitHub、GitLab 原生渲染。命令行渲染需安装 Mermaid CLI:npm install -g @mermaid-js/mermaid-cli,然后 mmdc -i diagram.mmd -o diagram.png -w 1200、mmdc -i diagram.mmd -o diagram.svg 或 mmdc -i diagram.mmd -o diagram.pdf。LaTeX 中可引入 mmdc 生成的 SVG(\usepackage{svg} 配合 \includesvg)。
实践建议:每张图聚焦一个概念,超过 15-20 个节点应拆分;用 subgraph 分组;为所有边加标签;统一配色(成功绿、失败红、流程蓝);论文优先导出 SVG;由于是文本,可在 Git 中清晰 diff;提交前可在 mermaid.live 在线编辑器快速调试。限制:资料未提及收费、价格、性能或效果数据;具体平台渲染差异未提供。