兼容性矩阵
哪里能渲染,哪里不能
一张按功能划分的 Mermaid 支持情况表,覆盖 GitHub、GitLab、Notion 和 Obsidian。各行数据来自下方的平台指南。 较新和 beta 阶段的图表类型被标记为「未验证」,而不是凭空猜测——在正式依赖某个类型之前,请先在目标平台上实际确认。
| 功能 | GitHub | GitLab | Notion | Obsidian |
|---|---|---|---|---|
| 核心图表类型flowchart、sequenceDiagram、classDiagram、stateDiagram-v2、erDiagram、gantt、pie、journey。 | 支持长期稳定的类型在 README、Issue 和 PR 中都能稳定渲染。 | 支持在 markdown、Issue、Merge Request 和 Wiki 中都能可靠渲染。 | 支持在 Mermaid 代码块内可靠渲染,并跟随页面主题。 | 支持在阅读视图和实时预览中原生渲染,无需插件。 |
| 较新 / beta 阶段的图表类型timeline、mindmap、quadrantChart、sankey-beta、xychart-beta、block-beta、architecture-beta、kanban、requirementDiagram、gitGraph。 | 未验证取决于 GitHub 当前部署的 Mermaid 版本——正式依赖之前请先在 GitHub 上实测。 | 未验证取决于实例的 Mermaid 版本;自托管 GitLab 可能明显落后于 GitLab.com。 | 未验证只有在 Notion 按自己的节奏更新内置 Mermaid 版本之后才可用。 | 未验证Obsidian 往往比其他平台更快跟进较新的 Mermaid 版本,但仍需逐版本确认。 |
| 交互式 click 指令用于节点链接和回调的 click 关键字。 | 不支持在 GitHub 的渲染沙箱中被禁用。 | 不支持GitLab 的渲染器不支持。 | 不支持在 Notion 的 Mermaid 代码块中不起作用。 | 有限支持受应用安全设置限制——不要依赖它。 |
| 自定义 %%{init}%% / 主题指令用于覆盖图表主题、颜色或配置的内联指令。 | 有风险可能被 GitHub 自己的浅色/深色主题忽略或覆盖。 | 有风险可能与 GitLab 的样式冲突,深色模式下尤其明显。 | 有风险与 Notion 自身的主题机制冲突;依赖颜色的图表可能变得难以辨认。 | 有风险可以生效,但样式只对你的仓库主题和 CSS 片段有效——在别处会呈现不同效果。 |
| 大型 / 密集图表节点、连线很多,或布局非常宽的图表。 | 有风险可能渲染失败或被截断;渲染区域是固定宽度的列。 | 有风险施加了体积与性能限制——过大的图表可能被截断或拒绝渲染。 | 有风险会缩小以适应页面栏宽;标签可能变得难以辨认。 | 有风险在移动端可能较卡顿,大型流程图的双指缩放体验也不太顺手。 |
自动生成,而非猜测
各 Mermaid 版本的图表类型支持情况
上面的平台表格是根据已发布的指南人工整理的。这一张不是:它由一次真实的测试运行生成(npm run test:version-matrix),会针对每个 Mermaid 版本实际发布的包,在无头 Chromium 中真实渲染每种图表类型的一个代表性模板。最近一次运行时间:2026-07-16。
| 图表类型 | Mermaid 9.4.3 | Mermaid 10.9.6 | Mermaid 11.14.0 |
|---|---|---|---|
| flowchart | 可渲染 | 可渲染 | 可渲染 |
| sequenceDiagram | 可渲染 | 可渲染 | 可渲染 |
| stateDiagram-v2 | 可渲染 | 可渲染 | 可渲染 |
| erDiagram | 可渲染 | 可渲染 | 可渲染 |
| timeline | 可渲染 | 可渲染 | 可渲染 |
| gantt | 可渲染 | 可渲染 | 可渲染 |
| classDiagram | 可渲染 | 可渲染 | 可渲染 |
| journey | 可渲染 | 可渲染 | 可渲染 |
| gitGraph | 可渲染 | 可渲染 | 可渲染 |
| pie | 可渲染 | 可渲染 | 可渲染 |
| mindmap | 可渲染 | 可渲染 | 可渲染 |
| quadrantChart | 渲染失败No diagram type detected for text: quadrantChart | 可渲染 | 可渲染 |
| sankey-beta | 渲染失败No diagram type detected for text: sankey-beta | 可渲染 | 可渲染 |
| xychart-beta | 渲染失败No diagram type detected for text: xychart-beta | 可渲染 | 可渲染 |
| kanban | 渲染失败No diagram type detected for text: kanban | 渲染失败No diagram type detected matching given configuration for text: kanban | 可渲染 |
| requirementDiagram | 可渲染 | 可渲染 | 可渲染 |
平台表格是人工整理的种子数据;上面的版本表格是真实的自动化产出,但只覆盖了 Mermaid 版本这一个维度——查看 路线图 了解把自动化测试扩展到各平台自身渲染引擎的计划。发现内容过时了?平台指南 里有每个平台更详细的说明,报错参考 则覆盖了其中一些行背后的解析失败原因。