📊

流程圖產生器

使用 Mermaid 語法和視覺化編輯器建立流程圖和圖表

實用指南

圖表類型

流程圖
預設

Mermaid 程式碼

預覽

點擊預覽按鈕渲染圖表

❓什麼是 Mermaid 流程圖

Mermaid 是一個基於文字的圖表工具,可以從類似 markdown 的語法產生圖表。它使用簡單的文字描述而不是拖放編輯器來建立流程圖、時序圖、甘特圖、類別圖、狀態圖等。語法使用關鍵字(graph、sequenceDiagram、gantt)後跟節點定義和連接(A-->B、participant Alice)。Mermaid 以 SVG 格式渲染圖表,使其可縮放並可嵌入文件、維基、簡報中。優點包括版本控制(圖表即程式碼)、輕鬆更新、一致的樣式以及不需要專門的圖表軟體。廣泛用於 GitHub markdown、Notion、GitLab、Confluence 和技術文件。

✨功能特點

📊

多種圖表類型

支援流程圖(graph TB/LR)、時序圖、甘特圖、類別圖、狀態機、ER 圖、圓餅圖、使用者旅程圖,帶特定類型的語法和渲染
✏️

雙重編輯模式

帶 Mermaid 語法醒目提示、自動完成和錯誤偵測的文字編輯器,或視覺化拖放編輯器(可選),帶雙向程式碼同步以即時更新圖表
🎨

可自訂主題

從內建主題(預設、森林、深色、中性)中選擇或自訂顏色、字體、形狀、線條樣式、節點間距以實現與品牌符合的一致圖表外觀
💾

多格式匯出

將圖表匯出為 SVG(可縮放向量)、PNG(帶可自訂解析度的點陣)、PDF(用於列印/共用)或複製 Mermaid 程式碼以嵌入 markdown 文件

🎯應用場景

技術文件

在 README 檔案、wiki 和技術文件中建立系統架構圖、API 流程圖和流程文件。直接在 markdown 中嵌入 Mermaid 程式碼,讓 GitHub、GitLab 和 Notion 自動渲染。

專案管理

使用甘特圖規劃專案時間線、視覺化任務相依關係和追蹤里程碑。以基於文字的圖表形式更新專案計劃,可以在版本控制中追蹤並輕鬆與團隊成員分享。

業務流程文件

使用流程圖記錄業務流程、審批流程和使用者旅程圖。與利益相關者分享流程圖表,並根據回饋輕鬆修改,無需專門的圖表軟體。

軟體設計

使用類別圖設計軟體架構,使用 ER 圖建模資料庫模式,使用狀態圖視覺化狀態機。將設計作為程式碼進行迭代,隨專案發展而演進。

📚實用指南

Mermaid 語法基礎

Mermaid 圖表以類型宣告開始:graph TD(流程圖從上到下)、graph LR(從左到右)、sequenceDiagram、gantt、classDiagram、stateDiagram、erDiagram、pie。節點定義為 id[文字] 或 id(文字) 用於不同形狀:[] 矩形、() 圓角、{} 菱形、(()) 圓形、[[]] 子例程。連接使用箭頭:-->(實線)、-.->(虛線)、==>(粗線)、--文字-->(帶標籤)。子圖分組節點:subgraph 標題 ... end。透過 %%{init: {'theme':'dark'}}%% 或內聯樣式 id:::className 樣式化。註解以 %% 開始。特殊字元跳脫或引用。縮排以提高可讀性。

圖表類型特性

流程圖:使用 graph TB/TD/BT/RL/LR 表示方向。支援決策節點(菱形)、過程(矩形)、開始/結束(圓角)。時序圖:定義參與者、訊息(->>、-->>、-x)、啟動框(activate/deactivate)、註釋(Note 向左/向右 of)。甘特圖:定義帶開始日期、持續時間、相依關係(之後 taskId)的任務。類別圖:定義類別、屬性、方法、關係(繼承 <|、組合 *--、聚合 o--)。狀態圖:狀態、轉換、選擇節點。每種類型都有特定的語法規則和渲染邏輯。

渲染引擎

Mermaid.js 函式庫將文字語法解析為抽象語法樹 (AST),然後使用 D3.js 進行圖形版面配置渲染為 SVG。版面配置演算法:Dagre 用於流程圖(階層式版面配置)、力導向用於有機形狀。SVG 產生建立形狀(<rect>、<circle>、<path>)、文字(<文字>)、連接器(<line>、帶標記的 <path>)。主題透過嵌入 SVG 的 CSS 類別套用。互動功能:縮放/平移、工具提示、點選處理程式。瀏覽器渲染使用 <div class="mermaid">...code...</div> 與 mermaid.initialize() 或獨立 SVG 產生。使用 Puppeteer/mermaid-cli 的伺服器端渲染可用於靜態輸出。

進階功能

Mermaid 支援進階圖表:子圖建立巢狀結構。使用 classDef 和 class 套用自訂 CSS 的樣式。連結:點擊 nodeId "url" 開啟 URL。回呼:點擊 nodeId callback 觸發 JavaScript 函式。節點中的 FontAwesome 圖示:fa:fa-icon。使用引號在標籤中進行 Markdown 格式化。序列支援迴圈(loop...end)、替代(alt/else/end)、並行(par...end)。甘特圖支援區段、里程碑、活動/完成/關鍵狀態。ER 圖顯示基數(||--o{,一對多)。安全性:清理使用者輸入以防止點選處理程式中的 XSS。版本相容性:檢查 Mermaid.js 版本以獲得語法支援。

💬Frequently Asked Questions

❓什麼是 Mermaid,為什麼使用基於文字的圖表?
Mermaid 是一個基於文字的圖表工具,可以從類似 markdown 的語法產生圖表。使用文字而不是圖形編輯器提供關鍵優勢:版本控制(圖表可以像程式碼一樣在 Git 中追蹤)、輕鬆協作(共用和編輯純文字)、自動化(以程式設計方式產生圖表)、一致性(主題確保統一樣式)以及不需要專門的軟體。它非常適合文件、技術寫作和開發工作流程。
💬我可以使用 Mermaid 建立哪些類型的圖表?
Mermaid 支援多種圖表類型:流程圖(流程圖、決策樹)、時序圖(系統互動、API 呼叫)、甘特圖(專案時間線)、類別圖(UML 物件模型)、狀態圖(狀態機)、ER 圖(資料庫架構)、圓餅圖(比例資料)、使用者旅程圖(使用者流程)和 Git 圖(分支歷史)。每種類型都有用於節點、連接和屬性的特定語法。
🔍如何匯出圖表以用於文件或簡報?
您可以匯出多種格式的圖表:SVG(可縮放向量圖形)用於任何尺寸的清晰渲染和在向量工具中編輯、PNG(點陣圖像)具有可自訂的解析度用於嵌入文件、PDF 用於列印和共用,或直接複製 Mermaid 程式碼以嵌入 Markdown 檔案、GitHub README、Notion 頁面、GitLab 維基 或 Confluence 文件中,這些平台原生支援 Mermaid。
💡我可以自訂圖表的外觀嗎?
可以,Mermaid 提供了豐富的自訂選項:內建主題(預設、forest、dark、neutral)可更改整體配色方案。您可以使用 classDef 定義自訂 CSS 類別並將其套用於節點。單個節點樣式支援自訂形狀、顏色、邊框和字型。連接樣式可以是實線、虛線或帶可選標籤的粗箭頭。進階使用者可以注入自訂 CSS 或使用主題變數來匹配品牌顏色和設計系統。
📚Mermaid 在所有平台上都支援嗎?
Mermaid 在許多平台上得到原生支援,包括 GitHub、GitLab、Notion、Confluence、VS Code 和 Obsidian。對於不支援的平台,您可以將圖表匯出為 SVG 或 PNG 並作為圖像嵌入。對於 Web 應用程式,您可以整合 Mermaid.js 函式庫以啟用客戶端渲染。

💡使用方法

1️⃣

選擇圖表類型

從下拉選單中選擇你需要的圖表類型(流程圖、時序圖、甘特圖等),並選擇一個主題風格。
2️⃣

編輯 Mermaid 代碼

在代碼編輯器中輸入 Mermaid 語法,或點擊「插入模板」按鈕載入預設模板作為起點。
3️⃣

實時預覽

輸入代碼後會自動渲染預覽,或點擊「預覽」按鈕手動刷新。使用縮放按鈕調整圖表大小。
4️⃣

匯出圖表

點擊「SVG」或「PNG」按鈕下載圖表圖片,或點擊「複製代碼」複製 Mermaid 代碼到剪貼簿。

User Comments

0 / 2000
Loading...