轉換與建立
Mermaid 轉 Typst
把 Mermaid 流程圖轉成 Typst 可編輯的 fletcher 圖表,語法無法對應時則提供轉換後的圖片。
Mermaid 轉 Typst 會取用以幾行 Mermaid 寫成的流程圖,並把它寫成 fletcher 圖表。fletcher 是用節點與箭頭繪製圖表的 Typst 套件。標籤、形狀與箭頭都留在原始碼中,方便你編輯。
最佳用途
標題為「最佳用途」的段落用於研究流程、方法圖、決策樹,以及其他重視連接關係多於美術的流程圖。
如果要手繪圖表,或在畫布上調整已轉換的圖表,請使用圖表編排器。如果是 LaTeX 文件,請使用 Mermaid 轉 LaTeX。
轉換流程圖
標題為「轉換流程圖」的段落- 開啟 「Mermaid 轉 Typst」,或執行
/mermaid-to-typst。 - 貼上 Mermaid 原始碼,或選擇 「載入範例」。
- 選擇 「轉換」。
- 閱讀結果下方的備註。它會告訴你拿到的是可編輯的 fletcher 程式碼,還是轉換後的圖片。
- 複製或儲存
diagram.typ。如果結果包含圖片,「儲存 ZIP」 會把圖片和原始碼一起保存。
範例:
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 版本
標題為「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 改為轉換圖片時
標題為「當 Oleafly 改為轉換圖片時」的段落有些 Mermaid 語法沒有安全的 fletcher 對應:其他圖表類型(例如循序圖)、子圖、style 與 classDef 行,以及像 a --> b --> c 這樣的連鎖連結。這時 Oleafly 會在你的裝置上繪製圖表,將它儲存為 assets/diagram.png,並傳回一段顯示該圖片的簡短 #figure。關係仍然看得到,但圖片無法像程式碼那樣編輯。
轉換在你的裝置上進行。Mermaid 輸入上限為 50,000 個字元。請用最終的寬度編譯結果,並檢查標籤換行、交叉與箭頭方向。