用途:Mermaid 是基于 Markdown 的图表工具,可在 GitHub、GitLab、Notion 和文档站点中渲染。本技能用于在 Markdown 文件中创建可视化图表,适合记录系统架构、可视化 API 流程与时序、创建数据库 ER 图、说明状态机、绘制项目时间线与甘特图、展示 Git 分支策略等场景。
主要能力:支持多种图表类型。流程图可设置方向(TB/BT/LR/RL)、节点形状、连接线样式、子图与样式类;时序图支持参与者、多种箭头、激活、注释、循环与条件分支;ER 图支持实体、字段与关系基数;状态图支持状态、转换与嵌套状态;类图支持可见性标记与关系类型;此外还有甘特图、Git 图、饼图、思维导图和时间线。
使用方式:在 Markdown 中以 ```mermaid 代码块包裹图表定义即可。例如流程图:flowchart LR 换行 A --> B --> C。注释使用 %%。节点建议使用有意义的 ID,可用子图组织内容,大型图表宜拆分。
渲染支持:GitHub 与 GitLab 的 .md 文件原生支持;Notion 使用代码块类型 "mermaid";VS Code 需安装扩展;Docusaurus 有可用插件;Obsidian 原生支持。
限制:资料未提供安装命令、收费或价格信息;实际渲染效果取决于目标平台,建议在 GitHub 或目标平台上测试渲染。资料未提供更多限制说明。