Convertitore online gratuito da MERMAID a PNG

PNG è utile quando un diagramma Mermaid deve essere inserito in un documento, una presentazione, un issue tracker o un archivio basato su immagini che non è in grado di visualizzare il sorgente Mermaid. La conversione crea inoltre un'istantanea visiva fissa da condividere, mentre il file Mermaid originale rimane modificabile.

Cos'è il formato MERMAID

Un file MERMAID è una definizione di diagramma in testo semplice, generalmente salvata con l'estensione .mermaid o .mmd. Contiene la sintassi Mermaid per diagrammi di flusso, mappe mentali, diagrammi di sequenza, diagrammi delle classi, diagrammi di stato, diagrammi entità-relazione e altri elementi grafici strutturati, anziché pixel memorizzati.

I file Mermaid vengono creati o modificati in Mermaid Live Editor, Mermaid CLI, Visual Studio Code con estensioni Mermaid e applicazioni come Obsidian, GitLab e GitHub che supportano il rendering Mermaid. È possibile trovarne uno quando un diagramma è memorizzato in un repository di codice sorgente, in un documento Markdown, in un'applicazione per appunti o in un progetto di documentazione.

Cos'è il formato PNG

PNG è un formato di immagine raster supportato dai browser web, dai software per ufficio, dagli strumenti per presentazioni, dai visualizzatori di immagini e dalla maggior parte dei sistemi di gestione dei documenti. Utilizza la compressione senza perdita, conserva le linee dai colori uniformi e il testo in modo migliore rispetto a JPEG e può memorizzare sfondi trasparenti.

PNG è adatto quando il destinatario ha bisogno di un'immagine ordinaria anziché della sintassi Mermaid. Non è ideale per modificare singoli elementi del diagramma o per diagrammi estremamente grandi, perché l'ingrandimento di un'immagine raster può far apparire testo e linee pixelati.

Come convertire MERMAID in PNG

Utilizzo di 101convert online

1. Aprire il convertitore da MERMAID a PNG su 101convert.com.
2. Caricare il file .mermaid o .mmd.
3. Avviare la conversione e scaricare il file .png generato.

Questa opzione non richiede software installato ed è adatta quando il file Mermaid non contiene informazioni sensibili.

Utilizzo di Mermaid CLI

Per conversioni locali ripetibili, installare Mermaid CLI con Node.js:

npm install -g @mermaid-js/mermaid-cli

Eseguire il rendering di un file sorgente con:

mmdc -i diagram.mermaid -o diagram.png

L'input può anche utilizzare l'estensione .mmd. Per aumentare la risoluzione raster, applicare un fattore di scala:

mmdc -i diagram.mmd -o diagram.png -s 2

Utilizzare un colore di sfondo quando la trasparenza non è adatta:

mmdc -i diagram.mmd -o diagram.png -b white

Mermaid CLI esegue il rendering del sorgente con un browser headless. Se l'installazione segnala un problema con Chromium o con il browser, seguire le istruzioni di configurazione del browser relative alla versione di Mermaid CLI prima di eseguire nuovamente il comando.

Utilizzo di un editor di diagrammi

Aprire il sorgente in Mermaid Live Editor o in un altro editor compatibile con Mermaid, verificare che l'anteprima venga visualizzata correttamente, quindi scegliere Export → PNG o il comando equivalente per l'esportazione delle immagini. Le impostazioni di esportazione possono consentire di utilizzare uno sfondo trasparente, selezionare un tema o modificare la scala.

Considerazioni sulla qualità e sulla compatibilità

Il PNG riflette il renderer Mermaid, la versione di Mermaid, il tema, i font disponibili e tutte le impostazioni di inizializzazione utilizzate durante l'esportazione. Pertanto, un diagramma può avere un aspetto diverso quando viene sottoposto al rendering da un'altra applicazione o versione.

Aumentare la scala di esportazione per i diagrammi che contengono etichette piccole; modificare la larghezza del PNG dopo l'esportazione non ripristina i dettagli persi. Conservare il sorgente Mermaid originale insieme al PNG, perché PNG non conserva nodi, collegamenti, regole di layout o testo modificabile.

Se la destinazione supporta la grafica vettoriale, SVG è generalmente migliore per i diagrammi grandi e per il ridimensionamento successivo. Scegliere PNG quando l'applicazione di destinazione accetta solo immagini raster o quando è richiesta un'immagine di dimensioni fisse.