进阶 mermaid.ai 2026-11-12 20:48:10 · 21 阅读

第18章 Mermaid 图标使用指南:Font Awesome 图标在节点中的内联渲染与配置

使用图标

图标为节点增加视觉含义——能让复杂图表一目了然,而无需添加更多文字。

为节点添加图标

Mermaid 支持在节点标签中内联使用 Font Awesome 图标。用 fa: 前缀加上图标名称即可:

flowchart LR A(["fa:fa-user User"]) B(["fa:fa-server Server"]) C(["fa:fa-database Database"]) A --> B --> C

图标会随节点标签一起内联渲染。节点形状由括号决定——用 ([ 表示圆角矩形,这种形状配图标效果最好。

找到合适的图标

Font Awesome 图标名称遵循 fa-[name] 的格式。常用图标如下:

图标名称适合表示Userfa:fa-user用户、角色、终端用户Serverfa:fa-server后端系统Databasefa:fa-database数据存储Cloudfa:fa-cloud云服务Lockfa:fa-lock认证、安全Checkfa:fa-check审批、完成Envelopefa:fa-envelope邮件、通知Cogfa:fa-cog设置、配置Codefa:fa-code代码、APIFilefa:fa-file文档

完整图标库:Font Awesome icons →

Mermaid 的图标注册表还支持其他图标集。可以在编辑器左侧面板的 Icons 下浏览可用图标,或查看图标注册表参考文档 →

仅显示图标的节点

要只显示图标不带标签,把标签文本留空即可:

A(["fa:fa-user"])

在可视化编辑器中添加图标

在可视化编辑器中,点击中间工具栏的图标按钮。搜索图标后点击即可放置到画布上。放置后,可以在图标工具栏中设置图标大小、背景形状、背景颜色、图标颜色和标签。

常见问题

图标没有渲染。请检查图标名称是否正确并带有 fa: 前缀。图标名称区分大小写,必须完全匹配。如果不确定名称,可以在编辑器的图标面板中搜索。

图标和标签没有对齐。这通常是节点形状的问题——圆角矩形 ([ 最适合图标加标签的组合。如果对齐仍有问题,可以试试去掉标签,改用 tooltip 或单独的标签节点。

接下来做什么?

为图标节点应用颜色和样式 | 创建自定义样式 →

导出图表并保留图标 | 导出图表 →

与利益相关者分享图表 | 分享图表 →

评论 (0)