# Mermaid zu Typst

Ein Mermaid-Flussdiagramm in ein bearbeitbares fletcher-Diagramm für Typst umwandeln, mit einem gerenderten Bild, wenn die Syntax sich nicht abbilden lässt.

Mermaid zu Typst nimmt ein Flussdiagramm, das als wenige Zeilen Mermaid geschrieben ist, und schreibt es als fletcher-Diagramm. Fletcher ist ein Typst-Paket zum Zeichnen von Diagrammen mit Knoten und Pfeilen. Beschriftungen, Formen und Pfeile bleiben im Quelltext, wo Sie sie bearbeiten können.

## Am besten geeignet

Nutzen Sie es für Forschungsabläufe, Methodendiagramme, Entscheidungsbäume und andere Flussdiagramme, bei denen die Verbindungen wichtiger sind als die Grafik.

Um ein Diagramm von Hand zu zeichnen oder ein umgewandeltes auf einer Zeichenfläche anzupassen, nutzen Sie den [Diagramm-Editor](/docs/figures-diagrams/). Für ein LaTeX-Dokument nutzen Sie [Mermaid zu LaTeX](/docs/tools/mermaid-to-latex/).

## Ein Flussdiagramm umwandeln

1. Öffnen Sie **Mermaid zu Typst** oder führen Sie `/mermaid-to-typst` aus.
2. Fügen Sie Mermaid-Quelltext ein oder wählen Sie **Beispiel laden**.
3. Wählen Sie **Umwandeln**.
4. Lesen Sie den Hinweis unter dem Ergebnis. Er sagt Ihnen, ob Sie bearbeitbaren fletcher-Code oder ein gerendertes Bild erhalten haben.
5. Kopieren oder speichern Sie `diagram.typ`. Wenn das Ergebnis ein Bild enthält, behält **ZIP speichern** das Bild zusammen mit dem Quelltext.

Beispiel:

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

Ein `flowchart` oder `graph` mit der Richtung `TD`, `TB`, `LR`, `BT` oder `RL`, mit Beschriftungen, Kantenbeschriftungen, gestrichelten oder dicken Verbindungen und üblichen Knotenformen wird zu fletcher-Code. Das Ergebnis beginnt mit der `#import`-Zeile für fletcher, gefolgt von einem `#diagram`-Aufruf mit einem `node` pro Kasten und einem `edge` pro Pfeil.

## Fletcher-Versionen

Die Importzeile nennt eine fletcher-Version, die auf Ihrem Typst läuft. Mit offenem Typst-Projekt wählt Oleafly sie anhand der Typst-Version dieses Projekts: fletcher 0.5.8 für Typst 0.13 und später, 0.5.5 für Typst 0.12 und 0.5.1 für ältere Versionen. Ohne offenes Typst-Projekt erhalten Sie 0.5.8.

Typst lädt fletcher beim ersten Kompilieren eines Dokuments, das es nutzt, von Typst Universe herunter. Danach funktioniert es offline.

## Wenn Oleafly stattdessen ein Bild rendert

Manche Mermaid-Syntax hat keine sichere fletcher-Abbildung: andere Diagrammtypen wie Sequenzdiagramme, Subgraphen, `style`- und `classDef`-Zeilen sowie verkettete Verbindungen wie `a --> b --> c`. Dann zeichnet Oleafly das Diagramm auf Ihrem Gerät, speichert es als `assets/diagram.png` und gibt ein kurzes `#figure` zurück, das dieses Bild zeigt. Die Beziehungen bleiben sichtbar, aber das Bild lässt sich nicht als Code bearbeiten.

Die Umwandlung läuft auf Ihrem Gerät. Die Mermaid-Eingabe ist auf 50.000 Zeichen begrenzt. Kompilieren Sie das Ergebnis in seiner endgültigen Breite und prüfen Sie Umbrüche von Beschriftungen, Kreuzungen und Pfeilrichtungen.
