Konvertieren und erstellen
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
Abschnitt betitelt „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. Für ein LaTeX-Dokument nutzen Sie Mermaid zu LaTeX.
Ein Flussdiagramm umwandeln
Abschnitt betitelt „Ein Flussdiagramm umwandeln“- Öffnen Sie Mermaid zu Typst oder führen Sie
/mermaid-to-typstaus. - Fügen Sie Mermaid-Quelltext ein oder wählen Sie Beispiel laden.
- Wählen Sie Umwandeln.
- Lesen Sie den Hinweis unter dem Ergebnis. Er sagt Ihnen, ob Sie bearbeitbaren fletcher-Code oder ein gerendertes Bild erhalten haben.
- Kopieren oder speichern Sie
diagram.typ. Wenn das Ergebnis ein Bild enthält, behält ZIP speichern das Bild zusammen mit dem Quelltext.
Beispiel:
flowchart LR question[Research question] --> search[Search literature] search --> decide{Enough evidence?} decide -->|Yes| write[Write synthesis] decide -.->|No| searchEin 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
Abschnitt betitelt „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
Abschnitt betitelt „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.