Per trasformare un diagramma Mermaid in un'immagine, esporta PNG o SVG da Mermaid Live Editor o con la CLI mmdc.
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.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.
| Obiettivo | Metodo | Formati | Installazione | Il codice lascia il tuo computer? |
|---|---|---|---|---|
| Un diagramma, subito | Mermaid Live Editor → Actions → PNG o SVG | PNG, SVG | No | Sì, incollato in una pagina web ospitata |
| Esportazione ripetibile o in blocco | mermaid-cli (mmdc) | SVG, PNG, PDF | Node.js, oppure un'unica esecuzione con npx | No, il rendering è locale |
| Anteprima mentre scrivi in Markdown | Estensione di VS Code oppure Obsidian | Anteprima; alcune estensioni esportano SVG/PNG | Estensione dell'editor | No |
| Documentazione sempre aggiornata | mmdc come passaggio di build in CI | SVG, PNG, PDF | Nella pipeline | Resta nella tua CI |
| Ridisegno modificabile e pronto per la rivista | SciFig FlowChart: descrivi il diagramma, o allega il testo Mermaid come file .md, e l'IA lo ridisegna con ogni riquadro, etichetta e freccia modificabile | SVG, PNG, JPG, PPTX | No, funziona nel browser | Sì, 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.

Esportare Mermaid in PNG dalla riga di comando
@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| Formato | Vettoriale | Adatto a | Da evitare quando |
|---|---|---|---|
| SVG | Contenitore vettoriale | Web e successive modifiche | La destinazione non accetta SVG |
| Contenitore vettoriale | Articoli scientifici, stampa, diapositive | L'editor di destinazione non conserva gli elementi necessari | |
| PNG | No | Anteprime e destinazioni che richiedono immagini raster | I 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 strumentoCome esportare Mermaid in PNG (e correggere output sfocati, minuscoli o tagliati)
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.-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-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 2graph TD invece di graph LR).-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-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 3mmdc. 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 3Esempi di timeline e diagramma di sequenza
.mmd.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 3sequenceDiagram
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.svgGli altri metodi di esportazione
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
Esportare da Obsidian e VS Code verso articoli e diapositive
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..mmd accanto al Markdown ed eseguine il rendering con mmdc dal terminale integrato.-s 3 o superiore solo quando un sistema di invio rifiuta i file vettoriali.
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: neutralsottoconfignel frontmatter YAML del diagramma. Prima di scegliere il tema per la stampa, controlla l'anteprima alle dimensioni finali. - Caratteri. Imposta
fontFamilynella configurazione e assicurati che il carattere scelto sia disponibile nell'ambiente di rendering. - Direzione. La scelta tra
graph LRegraph TDcambia 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 è adatto | Passa a SciFig FlowChart o a un editor vettoriale |
|---|---|
| Documentazione gestita con un sistema di controllo delle versioni | Una figura per un manoscritto che deve rispettare le convenzioni grafiche di una rivista |
| Diagrammi rigenerati a ogni build | Una disposizione spaziale precisa, controllata riquadro per riquadro |
| La disposizione automatica è sufficiente | Posizioni che rappresentano relazioni reali, come quelle anatomiche o una sequenza temporale |
| Sorgente solo testuale, facile da confrontare in revisione | Coautori 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.

.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
.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 gratisAltre 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).



