# Mermaid 轉 Typst

把 Mermaid 流程圖轉成 Typst 可編輯的 fletcher 圖表，語法無法對應時則提供轉換後的圖片。

Mermaid 轉 Typst 會取用以幾行 Mermaid 寫成的流程圖，並把它寫成 fletcher 圖表。fletcher 是用節點與箭頭繪製圖表的 Typst 套件。標籤、形狀與箭頭都留在原始碼中，方便你編輯。

## 最佳用途

用於研究流程、方法圖、決策樹，以及其他重視連接關係多於美術的流程圖。

如果要手繪圖表，或在畫布上調整已轉換的圖表，請使用[圖表編排器](/docs/figures-diagrams/)。如果是 LaTeX 文件，請使用 [Mermaid 轉 LaTeX](/docs/tools/mermaid-to-latex/)。

## 轉換流程圖

1. 開啟 **「Mermaid 轉 Typst」**，或執行 `/mermaid-to-typst`。
2. 貼上 Mermaid 原始碼，或選擇 **「載入範例」**。
3. 選擇 **「轉換」**。
4. 閱讀結果下方的備註。它會告訴你拿到的是可編輯的 fletcher 程式碼，還是轉換後的圖片。
5. 複製或儲存 `diagram.typ`。如果結果包含圖片，**「儲存 ZIP」** 會把圖片和原始碼一起保存。

範例：

```mermaid
flowchart LR
  question[Research question] --> search[Search literature]
  search --> decide{Enough evidence?}
  decide -->|Yes| write[Write synthesis]
  decide -.->|No| search
```

方向為 `TD`、`TB`、`LR`、`BT` 或 `RL` 的 `flowchart` 或 `graph`，只要具備標籤、邊的標籤、虛線或粗線連結與常見的節點形狀，就會轉成 fletcher 程式碼。結果會以 fletcher 的 `#import` 行開頭，接著是一個 `#diagram` 呼叫，每個方框對應一個 `node`，每個箭頭對應一個 `edge`。

## fletcher 版本

`#import` 行會指定能在你的 Typst 上執行的 fletcher 版本。開啟 Typst 專案時，Oleafly 會依該專案的 Typst 版本挑選：Typst 0.13 及更新版本使用 fletcher 0.5.8，Typst 0.12 使用 0.5.5，更舊的版本使用 0.5.1。沒有開啟 Typst 專案時，你會得到 0.5.8。

Typst 會在第一次編譯使用 fletcher 的文件時，從 Typst Universe 下載它。之後就能離線運作。

## 當 Oleafly 改為轉換圖片時

有些 Mermaid 語法沒有安全的 fletcher 對應：其他圖表類型（例如循序圖）、子圖、`style` 與 `classDef` 行，以及像 `a --> b --> c` 這樣的連鎖連結。這時 Oleafly 會在你的裝置上繪製圖表，將它儲存為 `assets/diagram.png`，並傳回一段顯示該圖片的簡短 `#figure`。關係仍然看得到，但圖片無法像程式碼那樣編輯。

轉換在你的裝置上進行。Mermaid 輸入上限為 50,000 個字元。請用最終的寬度編譯結果，並檢查標籤換行、交叉與箭頭方向。
