Termina il 1° dic. (PT)
SciFig
Tutorial··Aggiornato

Mermaid in PNG: esportare diagrammi in SVG e PDF (2026)

Esporta diagrammi Mermaid in PNG, SVG e PDF con Mermaid Live Editor, mermaid-cli, VS Code e CI, e correggi PNG sfocati, minuscoli o tagliati.

SciFig Team
SciFig Team
Redazione di SciFig

Per trasformare un diagramma Mermaid in un'immagine, esporta PNG o SVG da Mermaid Live Editor o con la CLI mmdc.

Risposta rapida: per un'esportazione singola da Mermaid a immagine, incolla il diagramma in Mermaid Live Editor e scarica PNG o SVG dal pannello Actions. Per esportazioni ripetibili o in blocco, usa il comando mmdc di mermaid-cli, che trasforma un file .mmd o Markdown in SVG, PNG o PDF. Se invece ti serve una versione modificabile e pronta per la rivista, SciFig FlowChart (diagrammi di flusso) fa ridisegnare all'IA il diagramma dalla tua descrizione, con ogni riquadro, etichetta e freccia modificabile, ed esporta in SVG, PNG o PPTX.
Per salvare un diagramma Mermaid come immagine senza installare nulla, incolla il codice nel convertitore da Mermaid a PNG di SciFig: visualizza il diagramma nel browser, ti permette di scegliere una scala di esportazione da 1× a 4× e uno sfondo bianco o trasparente, e scarica gratis PNG o SVG.

Mermaid crea diagrammi a partire da testo: è quindi comodo per la documentazione gestita con un sistema di controllo delle versioni. Per ottenere un file da inserire in un articolo scientifico, una diapositiva o un poster, però, devi scegliere formato e dimensioni. Se il PNG ha troppo pochi pixel, alla dimensione di stampa prevista risulterà poco nitido.

ObiettivoMetodoFormatiInstallazioneIl codice lascia il tuo computer?
Un diagramma, subitoMermaid Live Editor → Actions → PNG o SVGPNG, SVGNoSì, incollato in una pagina web ospitata
Esportazione ripetibile o in bloccomermaid-cli (mmdc)SVG, PNG, PDFNode.js, oppure un'unica esecuzione con npxNo, il rendering è locale
Anteprima mentre scrivi in MarkdownEstensione di VS Code oppure ObsidianAnteprima; alcune estensioni esportano SVG/PNGEstensione dell'editorNo
Documentazione sempre aggiornatammdc come passaggio di build in CISVG, PNG, PDFNella pipelineResta nella tua CI
Ridisegno modificabile e pronto per la rivistaSciFig FlowChart: descrivi il diagramma, o allega il testo Mermaid come file .md, e l'IA lo ridisegna con ogni riquadro, etichetta e freccia modificabileSVG, PNG, JPG, PPTXNo, funziona nel browserSì, caricato su SciFig

L'ultima riga è un tipo di strumento diverso: invece di eseguire il rendering del tuo codice Mermaid, l'IA ridisegna il diagramma dalla tua descrizione in SVG nativo, così ogni nodo, etichetta e freccia diventa un elemento che puoi spostare, ristilizzare e disporre secondo le convenzioni di una rivista. È gratuito per iniziare, senza carta, con 150 crediti il primo giorno, e la modifica e l'esportazione in SVG/PNG/PPTX sono gratuite.

Codice di un diagramma di flusso Mermaid accanto al risultato esportato in SVG (Figura generata con SciFig)
Codice di un diagramma di flusso Mermaid accanto al risultato esportato in SVG (Figura generata con SciFig)

Esportare Mermaid in PNG dalla riga di comando

Lo strumento ufficiale è @mermaid-js/mermaid-cli, che mette a disposizione il comando mmdc:
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
Scegli SVG o PDF se la destinazione li accetta. Linee ed etichette vettoriali restano nitide quando ridimensioni il diagramma; le immagini raster incorporate mantengono invece la loro risoluzione originale. Per il PNG, imposta un fattore di scala e verifica che il numero di pixel sia sufficiente per le dimensioni e la risoluzione di stampa richieste.
FormatoVettorialeAdatto aDa evitare quando
SVGContenitore vettorialeWeb e successive modificheLa destinazione non accetta SVG
PDFContenitore vettorialeArticoli scientifici, stampa, diapositiveL'editor di destinazione non conserva gli elementi necessari
PNGNoAnteprime e destinazioni che richiedono immagini rasterI pixel non bastano per le dimensioni finali
mmdc legge anche il Markdown. mmdc -i notes.md -o notes-rendered.md esegue il rendering di ogni blocco di codice mermaid del file in un'immagine e scrive una copia del Markdown che punta a quelle immagini: comodo per un README o un quaderno di laboratorio pieno di diagrammi.

Vedi la generazione di figure scientifiche IA in azione

Osserva come i ricercatori creano figure scientifiche pronte per la pubblicazione da descrizioni testuali.

Esplora lo strumento

Come esportare Mermaid in PNG (e correggere output sfocati, minuscoli o tagliati)

Per ottenere un file PNG da un diagramma Mermaid, passa a mmdc un nome di output che termina in .png. Il PNG viene ritagliato attorno al diagramma e le sue dimensioni dipendono da due impostazioni: la larghezza della pagina in cui il diagramma viene impaginato e il fattore di scala. La maggior parte dei problemi con i PNG si risolve con una delle correzioni seguenti.
PNG sfocato: aumenta la scala. -s moltiplica la densità di pixel senza cambiare il layout. -s 2 va bene per le diapositive, -s 3 o -s 4 per la stampa.
mmdc -i diagram.mmd -o diagram.png -s 3
Testo minuscolo in un diagramma largo: allarga la pagina. -w imposta la larghezza della pagina (800 px per impostazione predefinita) e -H l'altezza (600 px). Mermaid rimpicciolisce un diagramma largo per farlo entrare nella pagina, quindi un lungo diagramma di flusso da sinistra a destra può uscire con etichette illeggibili. Una pagina più larga mantiene le etichette a grandezza piena.
mmdc -i diagram.mmd -o diagram.png -w 1600 -s 2
Output tagliato o compresso: esporta prima in SVG. Se le etichette sono tagliate o affollate, genera un SVG e aprilo in un browser. Se l'SVG è corretto, il problema è la dimensione della pagina o la scala; se è sbagliato anche l'SVG, accorcia le etichette o cambia direzione (graph TD invece di graph LR).
Riquadro bianco dietro il diagramma: usa uno sfondo trasparente. -b imposta lo sfondo per PNG e SVG (non per PDF). Il valore predefinito è il bianco.
mmdc -i diagram.mmd -o diagram.png -b transparent -s 3
Carattere o tema sbagliato: mettili in un file di configurazione. -c carica una configurazione JSON per Mermaid, così tutti i diagrammi che esporti condividono lo stesso carattere e lo stesso tema. -t sceglie un tema integrato (default, forest, dark, neutral) per una singola esecuzione.
{
  "theme": "neutral",
  "themeVariables": { "fontFamily": "Arial" }
}
mmdc -i diagram.mmd -o diagram.png -c config.json -s 3
I temi dell'editor non vengono esportati. Un tema scuro di VS Code, la modalità scura di Obsidian o un tema scelto nell'interfaccia di un editor cambiano solo l'aspetto dell'anteprima. Il file esportato usa il tema scritto nel diagramma (una riga init o il frontmatter) o passato a mmdc. Se l'esportazione è diversa dall'anteprima, scrivi il tema nel diagramma.
mmdc non si installa: eseguilo con npx. Le installazioni globali falliscono sui computer con permessi limitati. npx scarica la CLI in una cache e la esegue una volta, senza installazione globale. Alla prima esecuzione scarica anche un browser headless, quindi servono alcuni minuti.
npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3

Esempi di timeline e diagramma di sequenza

Questi esempi minimi si esportano con gli stessi comandi. Salva ciascuno come file .mmd.
Esempio di timeline Mermaid (immagine/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
Esempio di diagramma di sequenza Mermaid:
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

Gli altri metodi di esportazione

Mermaid Live Editor. L'editor nel browser esporta SVG e PNG direttamente dal pannello Actions ed è l'opzione più rapida per un singolo diagramma, ma richiede di incollare il diagramma in un servizio ospitato: un aspetto da considerare se il contenuto è sensibile.
Convertitore da Mermaid a PNG di SciFig. Incolla il codice Mermaid nel convertitore da Mermaid a PNG, genera l'anteprima e scarica PNG o SVG. Per un PNG più nitido scegli una scala più alta tra 1× e 4×; per diapositive con sfondo colorato scegli lo sfondo trasparente. Se il codice contiene un errore di sintassi, lo strumento indica dove si trova invece di esportare un'immagine difettosa: correggi la riga e ripeti il rendering.
VS Code. L'estensione Markdown Preview Mermaid Support visualizza i diagrammi in linea, e l'estensione Mermaid Editor aggiunge l'esportazione diretta in SVG e PNG. Comoda durante la stesura.
Pipeline CI. Essendo uno strumento a riga di comando, mmdc può generare i diagrammi durante la build. Una pratica comune è salvare i sorgenti .mmd nel repository e creare le immagini durante la build della documentazione, così il risultato resta allineato al codice sorgente.
- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
Pipeline CI che genera immagini dai sorgenti Mermaid nel repository durante la build della documentazione (Figura generata con SciFig)
Pipeline CI che genera immagini dai sorgenti Mermaid nel repository durante la build della documentazione (Figura generata con SciFig)

Esportare da Obsidian e VS Code verso articoli e diapositive

Obsidian. Obsidian visualizza i blocchi di codice mermaid nell'anteprima della nota, ma non ha un pulsante integrato per salvare un singolo diagramma come file immagine. Esportando la nota in PDF, il diagramma viene incluso. Per un PNG o SVG separato, copia il blocco di codice in Mermaid Live Editor, oppure salvalo come file .mmd ed esegui mmdc. Poiché mmdc legge il Markdown, puoi anche indicare direttamente la nota.
VS Code e anteprime Markdown. Un'estensione di anteprima Mermaid mostra il diagramma mentre scrivi. Per esportare in PNG un diagramma Mermaid scritto in Markdown in VS Code, usa un'estensione che supporti l'esportazione, oppure tieni il diagramma in un file .mmd accanto al Markdown ed eseguine il rendering con mmdc dal terminale integrato.
Articoli e diapositive. Esporta in SVG (o in PDF per LaTeX), non in PNG. In PowerPoint, inserisci l'SVG come immagine; le versioni recenti possono convertirlo in forme, così puoi ricolorare i riquadri. In Illustrator o Inkscape, apri l'SVG per regolare spaziature, caratteri e punte delle frecce prima di inserirlo nel manoscritto. Usa il PNG a -s 3 o superiore solo quando un sistema di invio rifiuta i file vettoriali.
Lo stesso diagramma di flusso Mermaid con il tema predefinito e quello neutro, a confronto per la leggibilità in stampa (Figura generata con SciFig)
Lo stesso diagramma di flusso Mermaid con il tema predefinito e quello neutro, a confronto per la leggibilità in stampa (Figura generata con SciFig)

Regolare l'aspetto del diagramma

Le impostazioni predefinite di Mermaid sono pensate per la documentazione. Per una figura destinata alla pubblicazione, conviene intervenire su tre aspetti:

  • Tema. Imposta theme: neutral sotto config nel frontmatter YAML del diagramma. Prima di scegliere il tema per la stampa, controlla l'anteprima alle dimensioni finali.
  • Caratteri. Imposta fontFamily nella configurazione e assicurati che il carattere scelto sia disponibile nell'ambiente di rendering.
  • Direzione. La scelta tra graph LR e graph TD cambia il rapporto tra larghezza e altezza: un dettaglio decisivo quando il diagramma deve entrare in una colonna.

Un diagramma di flusso di un processo di ricerca con tema neutro e un carattere adatto alla stampa:

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

Quando serve uno strumento diverso da Mermaid

Mermaid dispone gli elementi automaticamente e lascia poco margine per modificarne la posizione. Questo semplifica la documentazione, ma può diventare un limite nelle figure scientifiche, dove la disposizione degli elementi contribuisce al significato.

Mermaid è adattoPassa a SciFig FlowChart o a un editor vettoriale
Documentazione gestita con un sistema di controllo delle versioniUna figura per un manoscritto che deve rispettare le convenzioni grafiche di una rivista
Diagrammi rigenerati a ogni buildUna disposizione spaziale precisa, controllata riquadro per riquadro
La disposizione automatica è sufficientePosizioni che rappresentano relazioni reali, come quelle anatomiche o una sequenza temporale
Sorgente solo testuale, facile da confrontare in revisioneCoautori che modificano la figura visivamente invece che nel codice

Un compromesso praticabile: crea la struttura in Mermaid, esportala in SVG e rifiniscila in un editor vettoriale, accettando che le modifiche manuali non sopravvivano a una nuova generazione dal sorgente.

Diagramma con disposizione automatica di Mermaid accanto alla stessa struttura riorganizzata per un articolo scientifico (Figura generata con SciFig)
Diagramma con disposizione automatica di Mermaid accanto alla stessa struttura riorganizzata per un articolo scientifico (Figura generata con SciFig)
Un'altra strada è ridisegnarlo in SciFig FlowChart (diagrammi di flusso). Descrivi il diagramma in linguaggio naturale, o allega il testo Mermaid come file .md, e con il generatore di diagrammi da testo l'IA disegna una versione modificabile in SVG nativo, in cui ogni riquadro, etichetta e freccia può essere spostato e ristilizzato direttamente. Per un'interazione come l'esempio di sequenza visto sopra, il generatore di diagrammi di sequenza fa lo stesso con partecipanti e messaggi. È gratuito per iniziare, con 150 crediti il primo giorno, e la modifica, il salvataggio e l'esportazione in SVG, PNG o PPTX sono gratuiti. Se stai valutando strumenti di design basati su template per lo stesso lavoro, consulta le nostre alternative a Canva per i diagrammi.

Suggerimento

Salva nel repository il sorgente .mmd insieme all'immagine esportata. Le differenze nel sorgente sono facili da esaminare durante la revisione e permettono di rigenerare il diagramma dopo una modifica; l'immagine è ciò che il lettore vede. Conservandone solo uno, rinunci alla facilità di revisione oppure alla praticità d'uso.

Crea figure scientifiche ora

Descrivi la tua figura scientifica in linguaggio naturale — ottieni illustrazioni pronte per la pubblicazione in pochi minuti.

Prova gratis
Per le figure di pubblicazione che vanno oltre i diagrammi, lo strumento da testo a figura gestisce le illustrazioni. La guida alla visualizzazione della ricerca illustra il flusso di lavoro più ampio.

Altre letture

Letture correlate: Visualizza la ricerca istantaneamente con AI Testo a Figura, 10 migliori strumenti di illustrazione scientifica nel 2026, 7 alternative gratuite a Canva per diagrammi (2026).

Domande frequenti

Continua

Risorse consigliate

Template, strumenti e letture di approfondimento per la tua ricerca

Sfondo della call to action

Pronto per iniziare?

Figure scientifiche pronte per la pubblicazione, in pochi minuti

Inizia gratuitamente

Gratis per iniziare · Nessuna carta di credito richiesta · Costruito per i ricercatori