讓 Mermaid 圖照你的順序,一步一步講清楚。

在圖表後面加幾行 timeline,決定每一步要顯示、隱藏或強調什麼。圖和講解存在同一份文字,貼進 Playground 就能播放。

在瀏覽器播放,不用安裝任何套件。

how-it-works.srn+ 是你加上的行
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-board
API 文件

一行一步,四個動作。

每一行 timeline 是一步,寫下這一步要動哪些元素。同一行可以用逗號列好幾個。

  • 目標用圖裡的 id:節點寫 Pay,連線寫 Cart-Pay
  • 寫了 enter 的元素,在那一步之前都不會出現
  • 指到不存在的 id,會告訴你是哪一行
完整的 timeline 語法
動作做什麼例子
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

讓圖表,跟著你的故事前進。