讓 Mermaid 圖照你的順序,一步一步講清楚。
在圖表後面加幾行 timeline,決定每一步要顯示、隱藏或強調什麼。圖和講解存在同一份文字,貼進 Playground 就能播放。
在瀏覽器播放,不用安裝任何套件。
flowchart TB
%% 原本的 Mermaid 圖,一個字都不用改
Idea([描述想畫的流程]) --> Write[Skill 產出 .srn]
Mermaid([現有 Mermaid 靜態圖]) --> AddTimeline[Skill 加上 timeline]
subgraph Studio [Playground]
Theme[選擇主題] --> Tune[調整主題]
end
Write --> Theme
AddTimeline --> Theme
Tune ==> Play((播放))
Tune --> PPT[(匯出 PPT)]
Tune --> Image[/匯出圖片/]
timeline:
%% 一行就是一步,點一下可以跳過去
0 / 8兩個起點:描述流程,或現有的圖
一份文字,交給三種人。
寫講解的人、看講解的人,和把播放器放進自己產品的人,拿到的都是同一份 .srn。
寫的人
圖和講解,存在同一份文字。
用 Mermaid 畫圖,用 timeline 編排順序。整份是純文字,可以跟程式碼放在一起,用 Git 審查、修改。
Bank --> Done[訂單成立] + Bank -.-> Retry[重新付款] … + highlight Retry outline閱讀 timeline 語法
看的人
貼上就能播,照自己的步調看。
收到的人把文字貼進 Playground,就能前進、倒退、切換路線。不用安裝,也不用架開發環境。
← 上一步下一步 →success ▾完整圖
開啟 Playground整合的人
開源引擎,放進自己的應用。
siren-core 把文件畫成 SVG,siren-board 是現成的播放器,附步驟按鈕、自動播放和路線切換。MIT 授權。
npm install siren-core siren-boardAPI 文件一行一步,四個動作。
每一行 timeline 是一步,寫下這一步要動哪些元素。同一行可以用逗號列好幾個。
- 目標用圖裡的 id:節點寫
Pay,連線寫Cart-Pay - 寫了
enter的元素,在那一步之前都不會出現 - 指到不存在的 id,會告訴你是哪一行
| 動作 | 做什麼 | 例子 |
|---|---|---|
| enter | 元素在這一步出現:fade,或從四個方向 slide 進來 | enter Pay fade |
| exit | 元素在這一步消失,位置保留,其他元素不會跑掉 | exit Retry slide-left |
| highlight | 強調元素:outline 加粗外框,glow 讓它發光 | highlight Bank glow |
| unhighlight | 取消強調,回到原本的樣子 | unhighlight Bank |
同一張圖,不同路線。
給 timeline 取名,付款成功和失敗重試各寫一條。圖只畫一次,讀者在播放器裡選要看哪一條。
timeline success: … exit Retry fade, exit Bank-Retry fade, highlight Done outline, unhighlight Banktimeline retry: … exit Done fade, exit Bank-Done fade, highlight Retry outline, unhighlight Bank
flowchart sequenceDiagram classDiagram
stateDiagram erDiagram gantt
六種常用的 Mermaid 圖
原本的圖不用改寫。尚未支援的語法會明確回報是哪一行,不會默默畫錯。
--siren-node-fill: #f3efff;
--siren-highlight-color: #0d9488;
外觀用 CSS 換
顏色、線條和字型都是 --siren-* 設計 token,在自己的 CSS 覆寫就能換成你的主題。
~/.claude/skills/siren/SKILL.md
讓 AI 幫你寫
裝上 Siren 的 agent skill,Claude Code 等 AI agent 就會畫圖、排 timeline,並自己驗證到能渲染為止。
用 AI 寫 Siren