用途:把口头或书面的流程、架构、数据模型、时间线与关系描述翻译成正确的 Mermaid 语法,输出使用 mermaid 标识的围栏代码块,可在 Obsidian、GitHub、GitLab、Notion 及现代 Markdown 环境原生渲染。Mermaid 是文本化图表语言,便于版本控制、diff 与直接嵌入 Markdown,无需上传图片。
主要能力:支持流程图(flowchart TD / graph LR)、时序图(sequenceDiagram)、类图(classDiagram)、状态图(stateDiagram-v2)、实体关系图(erDiagram)、思维导图(mindmap)、甘特图(gantt)、饼图(pie)、象限图(quadrantChart)、Git 图(gitGraph)、时间线(timeline)与 XY 图(xychart-beta)。工作流程为:先判断最合适的图表类型,类型不明确时先提一个澄清问题;再从描述中提取节点、边、子分组、标签与条件分支;然后按对应语法书写,并校验节点 ID 是否都存在、subgraph 是否闭合、箭头语法是否正确、含括号或逗号的标签是否加引号。
使用方式:输出形如 ```mermaid 的围栏代码块;简单请求只给代码块,复杂图表可加一行说明与渲染提示。渲染方式:Obsidian 原生支持无需插件;GitHub/GitLab 在 .md 与 wiki 中渲染;VS Code 可安装 Mermaid Preview 扩展;浏览器可用 mermaid.live 预览。
适用场景:用户要求画图、生成图表、把文字流程可视化、把已有图片转为 Mermaid、在笔记中加图,或明确提到 Mermaid、流程图、时序图等。
限制:仅输出文本图表,不适合手绘图或图片式图表;不支持带点击交互的图表(应改用 JavaScript 库);不用于 Excalidraw 或白板式画布;单个图表建议不超过 20 个节点,超过 8 个节点建议加子图分组;节点内 HTML 支持有限,应使用纯文本;classDiagram 中不支持 direction 关键字;含逗号的标签需写成 A["Name, Title"]。具体收费、价格与平台信息暂未提供。