# 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` が 1 つ、矢印ごとに `edge` が 1 つ付きます。

## fletcher のバージョン

インポート行には、お使いの 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 になります。

fletcher を使う文書を初めてコンパイルするとき、Typst は Typst Universe から fletcher をダウンロードします。それ以降はオフラインで動作します。

## 代わりに Oleafly が画像を描画するとき

Mermaid の構文には、fletcher に安全に対応づけられないものがあります。シーケンス図などの他の種類の図、サブグラフ、`style` 行と `classDef` 行、`a --> b --> c` のような連鎖したリンクです。その場合、Oleafly は図をお使いのデバイス上で描画して `assets/diagram.png` として保存し、その画像を表示する短い `#figure` を返します。関係は見えるままですが、画像はコードとして編集できません。

変換はお使いのデバイス上で行われます。Mermaid の入力は 50,000 文字までです。結果を最終的な幅でコンパイルして、ラベルの折り返し、線の交差、矢印の向きを確認してください。
