Endet am 1. Dez. (PT)
SciFig
Tutorials··Aktualisiert

Mermaid to PNG: Diagramme als SVG, PNG und PDF exportieren

Mermaid to PNG: Diagramme mit Live Editor, mermaid-cli, VS Code oder CI als PNG, SVG oder PDF exportieren und unscharfe oder abgeschnittene PNGs beheben.

SciFig Team
SciFig Team
SciFig-Redaktion

Ein Mermaid-Diagramm exportierst du mit dem Mermaid Live Editor oder der mmdc-CLI als PNG oder SVG.

Kurze Antwort: Für einen einmaligen Export fügst du das Diagramm in den Mermaid Live Editor ein und lädst PNG oder SVG über das Actions-Panel herunter. Für wiederholbare oder Stapel-Exporte nutzt du den Befehl mmdc von mermaid-cli, der eine .mmd- oder Markdown-Datei in SVG, PNG oder PDF umwandelt. Brauchst du stattdessen eine bearbeitbare, publikationsreife Fassung, zeichnet SciFig FlowChart (Flussdiagramme) das Diagramm per KI aus deiner Beschreibung neu, wobei jedes Feld, jede Beschriftung und jeder Pfeil bearbeitbar bleibt, und exportiert SVG, PNG oder PPTX.
Willst du ein Mermaid-Diagramm ohne Installation als Bild speichern, füge den Code in den SciFig-Konverter für Mermaid in PNG ein. Er stellt das Diagramm im Browser dar, lässt dich einen Exportfaktor von 1× bis 4× und einen weißen oder transparenten Hintergrund wählen und lädt PNG oder SVG kostenlos herunter.

Mermaid erzeugt Diagramme aus Text und eignet sich damit gut für Dokumentation unter Versionskontrolle. Soll das Ergebnis in ein Manuskript, eine Präsentation oder auf ein Poster, musst du Format und Größe bewusst wählen. Hat ein exportiertes PNG zu wenige Pixel, kann es in der vorgesehenen Druckgröße unscharf wirken.

ZielMethodeFormateInstallation nötigVerlässt der Code deinen Rechner?
Ein Diagramm, sofortMermaid Live Editor → Actions → PNG oder SVGPNG, SVGNeinJa, er wird in eine gehostete Webseite eingefügt
Wiederholbarer oder Stapel-Exportmermaid-cli (mmdc)SVG, PNG, PDFNode.js, oder einmalig per npxNein, lokales Rendering
Vorschau beim Schreiben von MarkdownVS-Code-Erweiterung oder ObsidianVorschau; manche Erweiterungen exportieren SVG/PNGEditor-ErweiterungNein
Immer aktuelle Dokumentationmmdc als CI-Build-SchrittSVG, PNG, PDFIn der PipelineBleibt in deiner CI
Bearbeitbare, publikationsreife NeuzeichnungSciFig FlowChart: Diagramm beschreiben oder den Mermaid-Text als .md-Datei anhängen; die KI zeichnet es neu, jedes Feld, jede Beschriftung und jeder Pfeil bleibt bearbeitbarSVG, PNG, JPG, PPTXNein, läuft im BrowserJa, wird zu SciFig hochgeladen

Die letzte Zeile ist eine andere Art von Werkzeug: Statt deinen Mermaid-Code zu rendern, zeichnet die KI das Diagramm aus deiner Beschreibung als natives SVG neu, sodass jeder Knoten, jede Beschriftung und jeder Pfeil als Element entsteht, das du verschieben, umgestalten und nach den Konventionen einer Fachzeitschrift anordnen kannst. Du kannst kostenlos starten, ohne Kreditkarte, mit 150 Credits am ersten Tag; Bearbeitung und Export als SVG, PNG oder PPTX sind kostenlos.

Mermaid-Flussdiagramm als Quelltext neben der daraus erzeugten SVG-Grafik (Abbildung mit SciFig erstellt)
Mermaid-Flussdiagramm als Quelltext neben der daraus erzeugten SVG-Grafik (Abbildung mit SciFig erstellt)

Export über die Kommandozeile

Das offizielle Werkzeug heißt @mermaid-js/mermaid-cli. Nach der Installation steht der Befehl mmdc zur Verfügung:
npm install -g @mermaid-js/mermaid-cli
 
mmdc -i diagram.mmd -o diagram.svg          # vector, preferred
mmdc -i diagram.mmd -o diagram.pdf          # vector PDF
mmdc -i diagram.mmd -o diagram.png -s 3     # raster at 3x scale
Wähle nach Möglichkeit SVG oder PDF, wenn das Ziel diese Formate unterstützt. Vektorlinien und Beschriftungen lassen sich ohne Schärfeverlust skalieren; eingebettete Rasterbilder behalten ihre ursprüngliche Auflösung. Wähle für PNG einen Skalierungsfaktor und prüfe, ob die erzeugten Pixelmaße zur gewünschten Druckgröße und Auflösung passen.
FormatVektorformatGeeignet fürUngeeignet, wenn
SVGContainer für VektorgrafikenWeb und weitere BearbeitungDas Ziel keine SVG-Dateien unterstützt
PDFContainer für VektorgrafikenManuskripte, Druck und PräsentationenDas verwendete Bearbeitungsprogramm die benötigten Elemente nicht erhält
PNGNeinVorschauen und Ziele, die Rasterbilder verlangenDie Pixelmaße für die endgültige Größe nicht ausreichen
mmdc liest auch Markdown. mmdc -i notes.md -o notes-rendered.md rendert jeden mermaid-Codeblock der Datei als Bild und schreibt eine Kopie des Markdown-Dokuments, die auf diese Bilder verweist – praktisch für ein README oder ein Laborjournal voller Diagramme.

KI-Abbildungsgenerierung in Aktion erleben

Sehen Sie, wie Forscher aus Textbeschreibungen publikationsreife wissenschaftliche Abbildungen erstellen.

Werkzeug erkunden

So exportierst du Mermaid als PNG (und behebst unscharfe, winzige oder abgeschnittene Ausgaben)

Um aus einem Mermaid-Diagramm eine PNG-Datei zu erzeugen, gibst du mmdc einen Ausgabenamen mit der Endung .png. Das PNG wird auf das Diagramm selbst zugeschnitten, und seine Größe ergibt sich aus zwei Einstellungen: der Seitenbreite, in der das Diagramm gesetzt wird, und dem Skalierungsfaktor. Die meisten Probleme mit schlechten PNGs lassen sich mit einer der folgenden Lösungen beheben.
Unscharfes PNG: Skalierung erhöhen. -s vervielfacht die Pixeldichte, ohne das Layout zu ändern. -s 2 passt für Folien, -s 3 oder -s 4 für den Druck.
mmdc -i diagram.mmd -o diagram.png -s 3
Winziger Text in einem breiten Diagramm: Seite verbreitern. -w legt die Seitenbreite fest (Standard 800 px), -H die Seitenhöhe (Standard 600 px). Mermaid verkleinert ein breites Diagramm, bis es auf die Seite passt, sodass ein langes Flussdiagramm von links nach rechts unlesbare Beschriftungen bekommen kann. Eine breitere Seite hält die Beschriftungen in voller Größe.
mmdc -i diagram.mmd -o diagram.png -w 1600 -s 2
Abgeschnittene oder gequetschte Ausgabe: zuerst SVG exportieren. Sind Beschriftungen abgeschnitten oder gedrängt, rendere SVG und öffne es im Browser. Sieht das SVG richtig aus, liegt das Problem bei Seitengröße oder Skalierung; sieht es ebenfalls falsch aus, kürze die Beschriftungen oder wechsle die Richtung (graph TD statt graph LR).
Weißer Kasten hinter dem Diagramm: transparenten Hintergrund verwenden. -b legt den Hintergrund für PNG und SVG fest (nicht für PDF). Standard ist Weiß.
mmdc -i diagram.mmd -o diagram.png -b transparent -s 3
Falsche Schrift oder falsches Theme: in eine Konfigurationsdatei schreiben. -c lädt eine JSON-Konfiguration für Mermaid, sodass alle exportierten Diagramme dieselbe Schrift und dasselbe Theme nutzen. -t wählt für einen einzelnen Aufruf ein integriertes Theme (default, forest, dark, neutral).
{
  "theme": "neutral",
  "themeVariables": { "fontFamily": "Arial" }
}
mmdc -i diagram.mmd -o diagram.png -c config.json -s 3
Editor-Themes werden nicht übernommen. Ein dunkles VS-Code-Theme, der Dark Mode von Obsidian oder ein in der Editor-Oberfläche gewähltes Theme ändert nur das Aussehen der Vorschau. Die exportierte Datei nutzt das Theme, das im Diagramm steht (Init-Zeile oder Frontmatter) oder an mmdc übergeben wird. Sieht der Export anders aus als deine Vorschau, schreibe das Theme in das Diagramm.
mmdc lässt sich nicht installieren: mit npx ausführen. Globale Installationen scheitern auf abgesicherten Rechnern. npx lädt die CLI in einen Cache und führt sie einmal aus, ganz ohne globale Installation. Beim ersten Aufruf wird zusätzlich ein Headless-Browser heruntergeladen, das dauert einige Minuten.
npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3

Beispiele für Timeline- und Sequenzdiagramme

Diese minimalen Beispiele lassen sich mit denselben Befehlen exportieren. Speichere jedes als .mmd-Datei.
Mermaid-Timeline-Beispiel (Bild/PNG):
timeline
    title Research project timeline
    2024 : Grant awarded
    2025 : Pilot study : Data collection
    2026 : Analysis : Manuscript submitted
mmdc -i timeline.mmd -o timeline.png -s 3
Mermaid-Sequenzdiagramm-Beispiel:
sequenceDiagram
    participant R as Researcher
    participant S as Sequencing core
    participant P as Analysis pipeline
    R->>S: Submit samples
    S-->>R: Raw reads
    R->>P: Run QC and alignment
    P-->>R: Results table
mmdc -i sequence.mmd -o sequence.svg

Weitere Wege zum Export

Mermaid Live Editor. Der Browsereditor exportiert SVG und PNG direkt über sein Actions-Panel und ist die schnellste Option für ein einzelnes Diagramm. Dabei fügst du dein Diagramm allerdings in einen gehosteten Dienst ein – bei vertraulichen Inhalten ein wichtiger Punkt.
SciFig-Konverter für Mermaid in PNG. Füge Mermaid-Code in den Konverter für Mermaid in PNG ein, erzeuge die Vorschau und lade PNG oder SVG herunter. Für ein schärferes PNG wählst du einen höheren Faktor zwischen 1× und 4×, für Folien mit farbigem Hintergrund einen transparenten Hintergrund. Enthält der Code einen Syntaxfehler, meldet das Tool die Fehlerstelle, statt ein fehlerhaftes Bild zu exportieren; du korrigierst die Zeile und renderst erneut.
VS Code. Erweiterungen für die Mermaid-Vorschau zeigen Diagramme direkt beim Schreiben an. Welche Exportmöglichkeiten sie bieten, hängt von der Erweiterung ab. Mit der oben gezeigten CLI kannst du gezielt SVG, PNG oder PDF erzeugen.
CI-Pipelines. Da mmdc ein Kommandozeilenwerkzeug ist, lässt sich das Rendern als Build-Schritt einbinden. Ein gängiger Ansatz: Du versionierst die .mmd-Quelldateien und erzeugst die Bilder beim Build der Dokumentation. So bleiben die Abbildungen auf dem Stand ihrer Quellen.
- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
CI-Pipeline mit versionierten Mermaid-Quelldateien und beim Dokumentations-Build erzeugten Bildern (Abbildung mit SciFig erstellt)
CI-Pipeline mit versionierten Mermaid-Quelldateien und beim Dokumentations-Build erzeugten Bildern (Abbildung mit SciFig erstellt)

Export aus Obsidian und VS Code sowie in Paper oder Folien

Obsidian. Obsidian rendert mermaid-Codeblöcke in der Notizvorschau, bietet aber keine integrierte Schaltfläche, um ein einzelnes Diagramm als Bilddatei zu speichern. Exportierst du die Notiz als PDF, wird das Diagramm mitgenommen. Für ein eigenständiges PNG oder SVG kopierst du den Codeblock in den Mermaid Live Editor oder speicherst ihn als .mmd-Datei und führst mmdc aus. Da mmdc Markdown liest, kannst du es auch direkt auf die Notiz anwenden.
VS Code und Markdown-Vorschauen. Eine Mermaid-Vorschau-Erweiterung zeigt das Diagramm während des Tippens. Um ein Mermaid-Diagramm aus Markdown in VS Code als PNG zu exportieren, nutzt du eine Erweiterung mit Exportfunktion oder legst das Diagramm als .mmd-Datei neben dein Markdown und renderst es mit mmdc im integrierten Terminal.
Paper und Folien. Exportiere SVG (oder PDF für LaTeX), nicht PNG. In PowerPoint fügst du das SVG als Bild ein; neuere Versionen können es in Formen umwandeln, sodass du Felder umfärben kannst. In Illustrator oder Inkscape öffnest du das SVG, um Abstände, Schriften und Pfeilspitzen anzupassen, bevor du es ins Manuskript setzt. Nutze PNG mit -s 3 oder höher nur, wenn ein Einreichungssystem Vektordateien ablehnt.
Dasselbe Mermaid-Flussdiagramm mit dem Standard- und dem neutralen Theme im Vergleich der Drucklesbarkeit (Abbildung mit SciFig erstellt)
Dasselbe Mermaid-Flussdiagramm mit dem Standard- und dem neutralen Theme im Vergleich der Drucklesbarkeit (Abbildung mit SciFig erstellt)

Das Erscheinungsbild anpassen

Mermaids Standardeinstellungen sind auf Dokumentation ausgerichtet. Für eine Publikation lohnt sich ein Blick auf drei Einstellungen:

  • Themes. Setze theme: neutral im YAML-Frontmatter des Diagramms unter config. Prüfe die Vorschau in der vorgesehenen Größe, bevor du dich für ein Theme für den Druck entscheidest.
  • Schriften. Lege über fontFamily eine Schrift fest und stelle sicher, dass sie in der Renderingumgebung verfügbar ist.
  • Richtung. graph LR und graph TD führen zu unterschiedlichen Seitenverhältnissen. Das kann entscheidend sein, wenn ein Diagramm in eine Spalte passen muss.

Ein Forschungsablauf als Flussdiagramm mit neutralem Theme und Druckschrift:

---
config:
  theme: neutral
  fontFamily: Helvetica
---
graph LR
  A[Sample collection] --> B[Extraction]
  B --> C[Sequencing]
  C --> D[Analysis]

Wann Mermaid an seine Grenzen stößt

Mermaid berechnet das Layout automatisch; auf die genaue Anordnung hast du nur begrenzten Einfluss. Für Dokumentation ist das praktisch. Bei wissenschaftlichen Abbildungen, in denen die Anordnung selbst etwas vermittelt, kann es zum Hindernis werden.

Mermaid passtWechsel zu SciFig FlowChart (Flussdiagramme) oder einem Vektoreditor
Dokumentation unter VersionskontrolleEine Manuskriptabbildung, die den Gestaltungsvorgaben einer Fachzeitschrift entsprechen muss
Diagramme, die bei jedem Build neu erzeugt werdenPräzise räumliche Anordnung, die du Feld für Feld steuerst
Automatisches Layout reicht ausPositionen, die reale Zusammenhänge wie anatomische Lage oder zeitliche Abfolge ausdrücken
Reiner Textquelltext, der sich im Review vergleichen lässtMitautorinnen und Mitautoren, die die Abbildung visuell statt im Code bearbeiten

Ein möglicher Kompromiss: Erzeuge die Struktur mit Mermaid, exportiere sie als SVG und bearbeite sie anschließend in einem Vektoreditor. Die manuelle Nachbearbeitung lässt sich dann allerdings nicht mehr allein aus dem Mermaid-Quelltext reproduzieren.

Automatisch angeordnetes Mermaid-Diagramm neben denselben Inhalten mit manuell angepasstem Layout für ein Manuskript (Abbildung mit SciFig erstellt)
Automatisch angeordnetes Mermaid-Diagramm neben denselben Inhalten mit manuell angepasstem Layout für ein Manuskript (Abbildung mit SciFig erstellt)
Ein anderer Weg ist eine Neuzeichnung in SciFig FlowChart. Beschreibe das Diagramm in Alltagssprache oder hänge deinen Mermaid-Text als .md-Datei an, und der Generator für Diagramme aus Text lässt die KI eine bearbeitbare Fassung als natives SVG zeichnen, in der sich jedes Feld, jede Beschriftung und jeder Pfeil direkt verschieben und umgestalten lässt. Für eine Interaktion wie das Sequenzbeispiel oben leistet der Sequenzdiagramm-Generator dasselbe für Teilnehmer und Nachrichten. Du kannst kostenlos mit 150 Credits am ersten Tag starten; Bearbeiten, Speichern und der Export als SVG, PNG oder PPTX sind kostenlos. Wenn du vorlagenbasierte Designwerkzeuge für dieselbe Aufgabe abwägst, lies unsere Canva-Alternativen für Diagramme.

Tipp

Versioniere die .mmd-Quelldatei zusammen mit dem exportierten Bild. Änderungen am Quelltext lassen sich im Review nachvollziehen, und das Diagramm lässt sich bei Bedarf neu erzeugen. Das Bild wiederum zeigt das Ergebnis auf einen Blick. Bewahrst du nur eine der beiden Dateien auf, fehlt dir entweder die nachvollziehbare Änderungshistorie oder die sofort nutzbare Abbildung.

Jetzt wissenschaftliche Abbildungen erstellen

Beschreiben Sie Ihre wissenschaftliche Abbildung in natürlicher Sprache - erhalten Sie publikationsreife Illustrationen in Minuten.

Kostenlos testen
Für Publikationsabbildungen über Diagramme hinaus übernimmt das Text-zu-Abbildung-Werkzeug die Illustrationen. Den gesamten Ablauf findest du in unserem Leitfaden zur Visualisierung von Forschung.

Weiterführende Artikel

Weiterführende Lektüre: Forschung sofort visualisieren mit KI Text-zu-Abbildung, 10 beste wissenschaftliche Illustrationswerkzeuge 2026, 7 kostenlose Canva-Alternativen für Forschungsdiagramme 2026.

Häufige Fragen

Weiterarbeiten

Empfohlene Ressourcen

Vorlagen, Tools und weiterführende Artikel für Ihre Forschung

Call-to-Action-Hintergrund

Bereit loszulegen?

Publikationsreife wissenschaftliche Abbildungen in Minuten

Kostenlos erstellen

Kostenlos starten · Keine Kreditkarte erforderlich · Für Forscher gebaut