PROVIDER - 用文本画图表的 Markdown 式工具

Mermaid

Mermaid 用 Markdown 风格的 1 段文本生成流程图、时序图与甘特图,被 GitHub、GitLab 等 4 个以上平台原生渲染,支持 10 多种图表类型且 MIT 开源;不足是复杂布局控制有限、大图渲染变慢。

开发工具 瑞典 2026.11.19
4.4分

详细说明

优势 5 项

用 Markdown 风格的 1 段文本即可生成流程图、时序图与甘特图
被 GitHub、GitLab、Gitea 等 4 个以上平台原生渲染,图表随代码一起同步
支持 10 多种图表类型,覆盖架构、状态机、类图与 ER 模型
以 MIT 许可开源,可按图表类型按需加载,减少 1 次整包引入
提供 Live Editor 在线编辑器,1 个链接即可分享与协作

不足 4 项

复杂布局控制能力有限,微调往往依赖语法技巧
节点数量很大时浏览器渲染会明显变慢
主题与样式定制需要额外编写 CSS
商业协作与版本治理能力在 Mermaid Chart 平台内

服务商概述

Mermaid 是「图表即代码」的代表工具,用类 Markdown 的语法把图表写进文档与代码库,由渲染器统一输出 SVG。

在开发工具分类里,它属于文档基础设施:图表与代码同仓同评审,避免设计文档长期漂移。

核心优势

  • 文本化图表:1 段描述即出图
  • 平台原生支持:4 个以上平台直接渲染
  • 图表类型丰富:10 多种可选
  • 开源免费:MIT 许可
  • 在线编辑:Live Editor 即时预览

产品生态

平台能力

流程图、时序图、类图、状态图、ER 图、甘特图与需求图渲染,主题配置、图标与交互扩展,以及命令行与 Node.js API。

集成

原生支持 GitHub、GitLab、Gitea、Azure DevOps、Notion 与 Obsidian,并可与 VS Code 插件、MkDocs、Docusaurus 组合。

典型场景

README 架构说明、接口时序文档、发布流程可视化、数据库关系图维护。

不足之处

  • 布局控制:精细排版能力弱
  • 性能边界:超大图渲染变慢
  • 样式定制:需要 CSS 知识
  • 商业功能:团队治理在付费平台

适用场景

  • 文档内嵌图表(★★★★★):与代码同仓最省心
  • 接口与时序说明(★★★★★):语法简洁
  • 高精度排版需求(★★☆☆☆):建议换专业绘图工具
  • 超大架构图(★★★☆☆):可拆分或换渲染后端

价格参考

项目 价格 备注
Mermaid 核心库 $0 MIT 许可,可商用
Live Editor $0 在线免费使用
Mermaid Chart 按用户订阅 团队协作与版本治理

常见问题

需要安装吗?

在 GitHub 等平台无需安装,本地渲染可用 CLI 或 Node.js 包。

支持中文吗?

支持,节点文字可直接使用中文。

与 PlantUML 的区别?

Mermaid 语法更贴近 Markdown 且平台支持更广,PlantUML 的 UML 表达更完整。

图表能放进文档站吗?

可以,MkDocs、Docusaurus 与 Sphinx 均有对应插件。

代码示例

sequenceDiagram
    participant U as User
    participant A as API
    participant D as Database
    U->>A: POST /orders
    A->>D: INSERT order
    D-->>A: order_id
    A-->>U: 201 Created
# 使用 CLI 渲染为 SVG
npm install -g @mermaid-js/mermaid-cli
mmdc -i diagram.mmd -o diagram.svg

# 输出 PNG 并指定背景
mmdc -i diagram.mmd -o diagram.png -b transparent

社区与资源

  • 官方网站:https://mermaid.js.org/
  • 源码仓库:https://github.com/mermaid-js/mermaid
  • 在线编辑器:https://mermaid.live/
前往 Mermaid 官网 → https://mermaid.js.org/
访问官网 ↗