Mermaid-Diagramme ansprechend exportieren
Dieser Leitfaden behandelt Mermaid-Diagramme und zeigt, wie sich textdefinierte Abläufe in konsistente und leicht editierbare Bilder verwandeln. Ziel ist kein beliebiger Screenshot, sondern ein lesbares, zur Markdown-Quelle rückverfolgbares und wiederholt publizierbares Asset.
PNG hält Text, Code, Tabellen und dünne Diagrammlinien scharf. JPEG kann bei fotografischen Hintergründen kleiner sein, macht kleine Schrift aber weicher. PDF passt zu mehrseitigem Lesen, DOCX zu editierbaren Office-Abläufen. Das Format muss zum Zielkanal passen.
- Vorbereiten. mit kleinem Flowchart und stabilen Knoten-IDs beginnen.
- Prüfen. Beschriftungen, Zweige, Richtung und Kontrast im Zielrenderer prüfen.
- Exportieren. Diagramm exportieren und Mermaid-Quelle daneben versionieren.
Dieses kleine Beispiel zuerst in den Renderer einsetzen und Typografie sowie Abstände prüfen.
CommonMark definiert den portablen Markdown-Kern. Tabellen, Task-Listen und manche Autolinks sind GFM-Erweiterungen und können anderswo abweichen. Mermaid und KaTeX sind eigene Syntaxen unterstützender Renderer. Der Zielkanal bleibt die maßgebliche Prüfung.
- Aussagekräftigen Alt-Text schreiben.
- Logische Überschriften und Lesereihenfolge sichern.
- Kontrast in hellen und dunklen Themes prüfen.
- Bild in tatsächlicher Anzeigegröße kontrollieren.
- Markdown-Quelle versionieren.
- Bei Änderungen neu exportieren statt Pixeltext zu flicken.
Zu kleine Schrift, zu breite Tabellen, unerklärte Abkürzungen, instabile Remote-Bilder und zu enger Beschnitt schaden. Identisches Rendering in jeder Engine darf nicht versprochen werden; Erweiterungen und Themes setzen Grenzen.
Die Grenzen dieses Updates wurden anhand folgender Primärquellen geprüft:
MarkdownToImage öffnen und das Beispiel in Zielbreite und Ziel-Theme testen. Verwandte Abläufe: erster Leitfaden und zweiter Leitfaden.