博客主题更新:现在支持 Mermaid 了

博客主题更新:现在支持 Mermaid 了

💡 原文中文,约900字,阅读约需2分钟。
📝

内容提要

博客新增 Mermaid 支持,可直接在 Markdown 中编写流程图、时序图等代码并渲染,无需导出上传图片。仅当文章包含 Mermaid 时才加载相关资源,版本固定为 12.0.0,支持深色模式与手机横向滚动,渲染失败时保留源码。适合维护简单且常改的图,复杂图仍建议使用专业工具。

🔎

延伸解读

按需加载与版本固定

文章强调,只有包含 Mermaid 代码块的文章才会加载对应的 CSS 和 JS,普通文章不受影响。同时 Mermaid 版本固定为 12.0.0,避免 CDN 上游更新导致兼容问题。这种设计在保持页面轻量的同时,也降低了因外部依赖变动而突然出错的风险。

移动端与深色模式适配

针对手机阅读,宽图可以横向滚动,不会撑出屏幕;图表主题也会跟随系统深色模式切换。这些细节提升了移动端和夜间阅读的体验,但文章未提及桌面端宽图的具体处理方式,实际效果可能因屏幕尺寸而异。

适用场景与局限

Mermaid 适合流程图、调用链、状态流转等简单且常改的图,源码直接写在 Markdown 里,修改和版本追踪都很方便。但复杂架构图或讲究排版的图,作者仍建议使用专业画图工具。渲染失败时源码会保留,避免内容丢失,但失败原因和恢复方式文章未展开。

Q&A

博客主题现在支持什么新功能?

博客主题现在支持 Mermaid,可以直接在 Markdown 中编写流程图、时序图等代码并渲染,无需先画图、导出、上传再补链接。

如何在博客文章中使用 Mermaid?

用法与普通代码块类似,将语言名替换为 mermaid,然后在代码块内编写 Mermaid 代码即可。

为什么博客现在才加入 Mermaid 支持?

以前博客里的图都是提前画好再上传,显示稳定但修改麻烦。Mermaid 更适合跟着文章一起维护的图,源码在 Markdown 里,改节点、改连线都很快,Git 里也能直接看到改动。

Mermaid 会替代所有图片吗?

不会。复杂架构图或讲究排版的图仍建议使用专门的画图工具,Mermaid 主要负责流程图、调用链、状态流转等简单又常改的内容。

Mermaid 资源是如何加载的?

Hugo 构建文章时会先判断有没有 Mermaid 代码块,有才把相关 CSS 和 JS 放进页面。普通文章不受影响,需要画图的文章也不用额外开配置。

Mermaid 的版本和兼容性如何?

Mermaid 版本固定为 12.0.0,避免 CDN 上游更新后突然出现兼容问题。图表会根据系统深色模式切换主题,手机上宽图可以横向滚动,渲染失败时保留 Mermaid 源码。

🏷️

标签

➡️

继续阅读