用途:根据 Mermaid 文本定义生成图表与流程图,借助 mermaid-cli(mmdc)输出文件,并附有 Mermaid 官方文档,供查阅各图表类型语法、配置和排错方法。
主要能力:支持多种图表类型,包括流程图、时序图、类图、状态图、ER 图、用户旅程、Gantt、看板、时间线、需求图、饼图、四象限图、XY 图、桑基图、Git 图、C4、块图、数据包图、架构图、思维导图、ZenUML、雷达图、树状图等。支持主题、自定义 CSS 与多种输出格式(SVG、PNG、PDF)。
使用方式:使用 mermaid-cli 校验代码并生成图表,例如:mmdc -i input.mmd -o output.png;生成 SVG:mmdc -i input.mmd -o output.svg;生成 PDF:mmdc -i input.mmd -o output.pdf;指定主题:mmdc -i input.mmd -o output.png -t dark;指定背景:mmdc -i input.mmd -o output.png -b transparent;指定宽度:mmdc -i input.mmd -o output.png -w 1920;指定高度:mmdc -i input.mmd -o output.png -H 1080。
限制与注意事项:默认 PNG 可能过小,需显式调整宽高以保证可读性;换行应使用 <br/>,不要使用普通换行符;标签避免以数字开头;在最终确定前应使用 mermaid-cli 验证语法;部分图表类型可能为实验性,语法仍在演进;官方文档持续更新,最新信息可参考 https://mermaid.js.org/。