501 字
3 分钟
页面浏览--访问次数--
Mermaid 图表

Shirone 原生集成了 Mermaid 图表渲染引擎,支持在 Markdown 中直接绘制流程图、时序图、甘特图、类图与状态图。

流程图(Flowchart)#

```mermaid
flowchart TD
A[用户请求] --> B{路由匹配}
B -->|命中静态文件| C[返回预渲染 HTML]
B -->|动态路由| D[Swup 客户端平滑切页]
C --> E[结束]
D --> E
```

渲染效果:

flowchart TD
    A[用户请求] --> B{路由匹配}
    B -->|命中静态文件| C[返回预渲染 HTML]
    B -->|动态路由| D[Swup 客户端平滑切页]
    C --> E[结束]
    D --> E

flowchart TD 表示自上而下布局,改写成 LR 即为从左到右。

时序图(Sequence Diagram)#

```mermaid
sequenceDiagram
autonumber
actor User as 访客
participant Browser as 浏览器
participant Server as 边缘服务器
User->>Browser: 点击文章链接
Browser->>Server: 发起页面资源请求
Server-->>Browser: 返回纯静态 HTML 与资源包
Browser-->>User: 渲染文章与动态配色
```

渲染效果:

sequenceDiagram
    autonumber
    actor User as 访客
    participant Browser as 浏览器
    participant Server as 边缘服务器

    User->>Browser: 点击文章链接
    Browser->>Server: 发起页面资源请求
    Server-->>Browser: 返回纯静态 HTML 与资源包
    Browser-->>User: 渲染文章与动态配色

autonumber 会自动为每条消息编号,实线箭头 ->> 表示请求,虚线箭头 -->> 表示响应。

状态图与架构图(State Diagram)#

```mermaid
stateDiagram-v2
[*] --> 默认浅色
默认浅色 --> 暗色模式: 切换主题
暗色模式 --> 默认浅色: 切换主题
暗色模式 --> [*]
```

渲染效果:

stateDiagram-v2
    [*] --> 默认浅色
    默认浅色 --> 暗色模式: 切换主题
    暗色模式 --> 默认浅色: 切换主题
    暗色模式 --> [*]

甘特图(Gantt)#

```mermaid
gantt
title 内容上线节奏
dateFormat YYYY-MM-DD
section 写作
初稿 :a1, 2026-10-01, 3d
配图与排版 :a2, after a1, 2d
section 发布
本地预览校对 :b1, after a2, 1d
推送并构建 :b2, after b1, 1d
```

渲染效果:

gantt
    title 内容上线节奏
    dateFormat  YYYY-MM-DD
    section 写作
    初稿            :a1, 2026-10-01, 3d
    配图与排版       :a2, after a1, 2d
    section 发布
    本地预览校对      :b1, after a2, 1d
    推送并构建        :b2, after b1, 1d

核心特性#

  • 按需加载:Mermaid 引擎仅在文章包含图表代码块时才会动态异步加载,不增加其他页面的初始打包体积。
  • 色彩与主题同步:图表线条、节点与文字颜色自动与当前站点的 Material 3 Expressive 主题色与明暗模式实时同步。
图表类型代码首行典型用途
流程图flowchart TD业务流程、渲染管线
时序图sequenceDiagram请求响应、协作过程
状态图stateDiagram-v2状态机、主题切换
甘特图gantt排期与时间线

第 25 篇,共 30 篇本文属于系列

Mermaid 图表
https://www.ariels.xyz/posts/charts-mermaid/
作者
Ariel
发布于
2026-10-11
许可协议
CC BY-NC-ND 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...