在 Markdown 中編寫流程圖主要通過 ??Mermaid 語法??實現(多數平臺如 GitHub、VS Code、Typora 已原生支持)。以下是詳細方法:
1. 基礎流程圖??
語法結構
用 ```` ```mermaid` 包裹代碼塊,指定方向后定義節點和連接線:
```mermaid
graph 方向節點定義節點連線
```
方向類型
LR
:從左到右(默認)TD
或TB
:從上到下RL
:從右到左BT
:從下到上
示例
對應代碼:
```mermaid
graph LRA[開始] --> B{條件判斷}B -->|是| C[執行操作]B -->|否| D[結束]
```
2. 節點類型??
基本節點
- ??矩形??:
[文本]
- ??圓角矩形??:
(文本)
- ??菱形(條件判斷)??:
{文本}
- ??圓形??:
((文本))
示例
對應代碼:
```mermaid
graph TDA[矩形節點]B(圓角節點)C{菱形節點}D((圓形節點))A --> B --> C --> D
```
3. 連接線樣式??
箭頭類型
- 實線:
-->
- 虛線:
-.->
- 加粗線:
==>
- 無箭頭線:
---
添加文字
在線條中間或右側添加描述:
對應代碼:
```mermaid
graph LRA -->|描述文字| BB -.->|虛線描述| CC ==> D
```
4. 子流程圖??
用 subgraph
定義子流程,適合復雜流程拆分:
對應代碼:
```mermaid
graph TBmain[主流程]subgraph 子流程模塊A[子步驟1]B[子步驟2]endmain --> 子流程模塊B --> C[后續步驟]
```
5. 高級用法??
節點樣式自定義
通過 style
修改顏色、邊框等:
對應代碼:
```mermaid
graph LRA[默認樣式]B[紅色背景]:::redC[綠色邊框]:::greenclassDef red fill:#ff9999,stroke:#333;classDef green stroke:#00cc00,stroke-width:2px;
```
注釋
用 %%
添加注釋(不會渲染):
對應代碼:
graph LRA --> B%% 這是一條注釋B --> C
6. 工具與調試??
支持平臺
- ??GitHub/GitLab??:需啟用 Mermaid 支持(部分平臺需插件)。
- ??VS Code??:安裝 Mermaid 插件
- 實時預覽。
- ??Typora??:原生支持,可直接編輯。
在線編輯器
- Mermaid Live Editor
- Draw.io
- (導出為圖片后插入 Markdown)
注意事項??
- ??縮進??:節點和子流程需統一縮進(2空格或 4空格)。
- ??兼容性??:確保目標平臺支持 Mermaid(如不支持,可用工具生成圖片后插入)。
- ??簡化邏輯??:避免過多嵌套,保持流程圖簡潔。