You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Material for MkDocs的Mermaid.js图表中添加图标?

在Material for MkDocs的Mermaid图表中添加图标的方法

我用Mermaid在线编辑器能正常渲染带Font Awesome图标的流程图,代码如下:

flowchart LR
    A[fas:fa-tree A] --> B(far:fa-gem B)

但把这段代码放到Material for MkDocs搭建的网站里,图标就显示不出来了。

我已经配置了Mermaid和Emoji这两个Markdown扩展,页面其他位置的:smile:、:material-server:这类图标都能正常显示,甚至本地部署了免费版Font Awesome图标后,:fa-regular-moon:这类自定义图标也能正常渲染,唯独Mermaid图表里的图标不行。

注意到Mermaid 10.1版本新增了Markdown格式化功能,理论上支持图标,但当前最新的Material for MkDocs 9.4.8集成的还是Mermaid 9.4.3版本。

我查过相关的讨论和文档,但没找到可行方案:

  • Font Awesome icons not loading #27
  • How to allow font awesome icons in mermaid diagrams? #5140
  • material 5.x does not render Font Awesome icons in mermaid diagrams
  • Advanced Mermaid Notes

请问怎么在Material for MkDocs的Mermaid图表里添加图标?


内容的提问来源于stack exchange,提问作者bitinerant

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.05 23:17:16