Convertitore online gratuito da MERMAID a PDF

PDF viene utilizzato quando un diagramma Mermaid deve essere condiviso con persone che non dispongono di un editor Mermaid, stampato o conservato in un layout fisso. La conversione del diagramma sorgente in PDF esegue il rendering del diagramma di flusso o della mappa mentale come documento portatile, invece di lasciarlo come codice di diagramma modificabile.

Che cos'è il formato MERMAID

Mermaid è un formato di diagrammi basato su testo, utilizzato per diagrammi di flusso, mappe mentali, diagrammi di sequenza, diagrammi entità-relazione, timeline e documentazione visiva correlata. I file utilizzano comunemente .mmd o .mermaid; il codice Mermaid può anche comparire all'interno di blocchi delimitati nei file Markdown.

Un file Mermaid contiene istruzioni sorgente come etichette dei nodi, connessioni, dichiarazioni del layout e stili, anziché un'immagine finita. Mermaid Live Editor, Mermaid CLI, le estensioni di Visual Studio Code, Obsidian e i sistemi di documentazione Markdown possono creare o eseguire il rendering di questi diagrammi.

Che cos'è il formato PDF

PDF memorizza il diagramma sottoposto a rendering insieme alle dimensioni della pagina, ai caratteri, ai colori e alle informazioni sul layout. È adatto per la stampa, gli allegati e-mail, la documentazione, i report tecnici e le copie d'archivio, perché i destinatari possono visualizzarlo con software PDF standard senza installare Mermaid.

PDF è normalmente un formato di presentazione, non un formato sorgente: per modificare il diagramma è generalmente necessario modificare il file Mermaid originale ed esportare un nuovo PDF.

Come convertire MERMAID in PDF

Utilizzo di Mermaid CLI

1. Installare Node.js se non è già installato.
2. Installare Mermaid CLI con npm install -g @mermaid-js/mermaid-cli.
3. Inserire il sorgente del diagramma in un file come flowchart.mmd. Assicurarsi che inizi con una sintassi Mermaid valida, ad esempio flowchart TD.
4. Eseguire mmdc -i flowchart.mmd -o flowchart.pdf.
5. Aprire flowchart.pdf e controllare le etichette, i connettori, le interruzioni di pagina e il rendering dei caratteri.

Per un diagramma che deve rientrare in un'unica pagina PDF, utilizzare mmdc -i flowchart.mmd -o flowchart.pdf --pdfFit. Il comando utilizza il renderer basato su Chromium di Mermaid, quindi il PDF contiene il diagramma sottoposto a rendering anziché il codice sorgente originale.

Utilizzo di 101convert.com

È possibile convertire il file su 101convert.com gratuitamente e senza installare software. Caricare il file Mermaid, selezionare PDF come formato di output, avviare la conversione e scaricare il documento risultante. Questa opzione è utile quando Node.js e Mermaid CLI non sono disponibili.

Utilizzo di un editor Mermaid

Aprire il sorgente in un editor che supporta il rendering Mermaid, quindi utilizzare Export → PDF oppure Print → Save as PDF del browser. La stampa dal browser è un'alternativa; può includere margini della pagina, intestazioni, piè di pagina o ridimensionamenti che non sono presenti in un'esportazione diretta da Mermaid CLI.

Considerazioni sulla qualità e sulla compatibilità

I diagrammi di grandi dimensioni possono essere ridotti fino a rendere difficili da leggere le etichette. Suddividere un sorgente affollato in più diagrammi, aumentare le dimensioni della pagina tramite la configurazione di Mermaid CLI oppure esportare PDF separati per sezioni diverse.

L'output PDF dipende dalla versione di Mermaid, dal tema di rendering, dai caratteri installati e dalle eventuali icone o risorse esterne utilizzate. Utilizzare la stessa versione di Mermaid CLI per ottenere esportazioni ripetibili e scegliere un carattere comune oppure incorporare i caratteri necessari tramite la configurazione del renderer quando il PDF verrà aperto su altri sistemi.

Le funzionalità interattive, la modificabilità del codice sorgente e alcuni stili specifici del browser non vengono trasferiti nel PDF. Conservare il file .mmd originale insieme al PDF quando sono probabili modifiche future.