# 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 には、生成されたソースに書かれたパッケージが必要です。