第16章 应用图表主题:快速定制 Mermaid 视觉风格
应用主题
主题只需一键就能改变整个图表的视觉风格(颜色、字体和线条样式)。在动手自定义样式之前,先从这里入手。
更换主题
在编辑器中打开一个图表。 点击顶部面板中的 Theme 选择器。 选择一个主题,图表会实时更新。
主题适合场景说明MermaidDefault — 干净、专业,通用性强默认主题,经典 Mermaid 风格Forest绿色调 — 适合自然、可持续发展或组织类内容Base唯一支持完全自定义的主题 — 想打造品牌风格从这里开始Dark深色背景 — 适合技术演示Neutral柔和灰阶 — 适合印刷或黑白文档
在图表语法中设置主题
在代码顶部使用 front matter 块,可以把主题锁定到特定图表。这样无论查看者的编辑器如何设置,图表都会使用该主题——分享或嵌入时很有用。 --- config: theme: forest --- flowchart LR A[Start] --> B[End] 可选值:default、neutral、dark、forest、base
base 是唯一支持通过 themeVariables 进行深度自定义的主题。如果想修改颜色、字体等 classDef 无法覆盖的属性,就以 base 作为起点。
在可视化编辑器中应用主题
在可视化编辑器中,点击中央工具栏的设计图标,从可用的主题和外观中选择,更改会立即应用到画布上。
常见问题
分享出去后主题看起来不一样:如果没有在 front matter 中锁定主题,图表会按查看者的默认设置渲染。添加一个 front matter 块来锁定它。
想自定义更多内容:主题只是起点——可以用 classDef 做节点级别的定制,或配合 base 主题使用 themeVariables 进行更深入的控制。创建自定义样式 →
下一步
为节点设置颜色和样式 | 创建自定义样式 → 为节点添加图标 | 使用图标 → 导出时保留样式 | 导出图表 →