用途:Mermaid 是 JavaScript 图表与图形工具,通过文本定义生成图表。本技能汇集其官方文档,重点是用 mermaid-cli(mmdc)在命令行校验语法并输出图形文件,适合流程图、时序图、类图、甘特图、ER 图等多种图表制作。
主要能力:覆盖多种图表语法,包括流程图、时序图、类图、状态图、实体关系图、用户旅程、甘特图、看板、时间线、需求图、饼图、象限图、XY 图、桑基图、Git 图、C4、块图、数据包图、架构图、思维导图、ZenUML、雷达图、树状图;并提供配置、主题、指令、图标、布局、数学表达式与无障碍等文档。
使用方式:先用 mermaid-cli 校验语法并生成图形。基本命令示例:mmdc -i input.mmd -o output.png;mmdc -i input.mmd -o output.svg;mmdc -i input.mmd -o output.pdf;可加 -t dark 指定主题,-b transparent 指定背景,-w 1920 指定宽度,-H 1080 指定高度。PNG 默认可能偏小,需显式调整宽高以保证可读性。
适用场景:生成流程图、架构图、数据图表、项目排期、数据库关系图等;也可用于网页集成前的命令行校验。
限制与注意:部分图表类型可能为实验性,语法仍在演进;最终成品前建议用 mermaid-cli 校验。换行用 <br/>,不要用普通换行;标签避免以数字开头,引号用 " 转义,& 易被转义为 &,可用“and”或“+”替代。CLI 问题可参考 Linux sandbox、已安装 Chromium、Docker 权限等相关文档。安装、收费、价格与效果等细节暂未提供。