# Mermaid 轉 LaTeX

盡可能把 Mermaid 流程圖轉成可編輯的 TikZ，其他圖表類型則在本機退回圖片。

Mermaid 轉 LaTeX 讓圖表從幾行好讀的文字開始，最後放進論文。常見的流程圖會變成可編輯的 TikZ，所以標籤、線條樣式與位置都能留在 LaTeX 原始碼中。

## 最佳用途

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

如果是含有圖表、領域專屬記號，或需要精確手動編排的發表用圖片，請改用[圖表與圖片工具](/docs/figures-diagrams/)。不要期待每一種 Mermaid 圖表都有忠實對應的 TikZ。如果是 Typst 文件，[Mermaid 轉 Typst](/docs/tools/mermaid-to-typst/) 會改寫出 fletcher 程式碼。

## 轉換流程圖

1. 開啟 **「Mermaid 轉 LaTeX」**，或執行 `/mermaid-to-latex`。
2. 貼上 Mermaid 原始碼，或載入範例。
3. 選擇 **「轉換」**。
4. 閱讀結果上方的備註，了解你拿到的是 TikZ，還是以圖片為基礎的 LaTeX 圖片。
5. 複製或儲存 `.tex` 原始碼與任何產生的資源檔。

範例：

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

方向為 `TD`、`TB`、`BT`、`LR` 或 `RL`，且只有基本節點與邊的常見流程圖，會以確定性的方式轉成 TikZ。如果語法用到了沒有安全 TikZ 對應的 Mermaid 功能，Oleafly 會在本機把圖表轉成 PNG，並傳回 LaTeX 圖片片段，而不是丟掉其中的關係。

## 檢查圖片

請用最終的欄寬編譯。檢查線條交叉、標籤換行、對比、字型大小，以及圖表的閱讀順序。請為看不到圖片的讀者加上說明性的圖說或文字替代內容。

轉換在你的裝置上進行。Mermaid 輸入上限為 50,000 個字元。圖片退回方式需要 `graphicx`；可編輯的 TikZ 則需要產生的原始碼中所列的套件。