Mermaid in Confluence

Mermaid trasforma poche righe di testo in un diagramma; in Confluence un’app disegna quel testo nella pagina, così un diagramma si corregge cambiando una riga.

Ultimo aggiornamento

Che cos’è Mermaid

Mermaid è un linguaggio open source per i diagrammi. Descrivi il diagramma con del testo e Mermaid lo disegna:

flowchart LR
  Draft[Write the page] --> Review{Reviewed?}
  Review -- Yes --> Publish[Publish]
  Review -- No --> Draft

Queste quattro righe sono un diagramma di flusso con tre passi e un ciclo. Per aggiungere un passo aggiungi una riga. Nessuno apre uno strumento di disegno, e nessuno cerca il file originale.

Perché scrivere i diagrammi come codice

  • Il diagramma resta corretto. Un’immagine invecchia perché per correggerla servono il file sorgente e lo strumento. Il codice si corregge dove si legge, da chiunque possa modificare la pagina.
  • Le modifiche si vedono. Il codice è testo, quindi la cronologia della pagina mostra che cosa è cambiato in un diagramma e chi lo ha cambiato.
  • La ricerca lo trova. Con Vellnar Diagrams le parole del codice sono indicizzate con la pagina, quindi una ricerca in Confluence del nome di un servizio o di una tabella trova la pagina con il diagramma.
  • La disposizione è automatica. Tu dici che cosa è collegato a che cosa; Mermaid mette al loro posto riquadri e frecce.

Come funziona in una pagina di Confluence

Confluence Cloud non ha una macro Mermaid integrata: la documentazione di Atlassian sul blocco di codice, sulle macro integrate e sugli elementi che puoi inserire non ne elenca nessuna (verificato il 21 novembre 2026). Un’app del Marketplace aggiunge la macro. Con Vellnar Diagrams:

  1. Modifica una pagina e scrivi /mermaid dove vuoi il diagramma.
  2. Seleziona Mermaid diagram. Si apre l’editor con 72 modelli.
  3. Scegli un modello o scrivi il tuo codice. L’anteprima segue ogni tasto e segna la riga con un errore.
  4. Scegli Save. Il diagramma è nella pagina, e chi legge può aprirlo a schermo intero, ingrandirlo, cercare nelle etichette ed esportarlo.

Il codice è salvato dentro la pagina. I permessi della pagina decidono chi vede il diagramma, e copiare, spostare o ripristinare la pagina fa lo stesso con il diagramma. La documentazione descrive ogni passo con gli screenshot.

Che cosa controllare quando scegli un’app

Diverse app del Marketplace disegnano Mermaid in Confluence. Sono diverse su fatti che puoi verificare prima di installare:

  • Dove è salvato il codice: nella pagina, in un allegato o in un account fuori da Atlassian.
  • Permessi: che cosa l’app può leggere e scrivere nel tuo sito. Confluence mostra l’elenco all’installazione.
  • Dati fuori da Atlassian: se l’app ha il badge “Runs on Atlassian”, e che cosa invia al suo vendor.
  • Esportazione in PDF: se una pagina esportata in PDF contiene il diagramma, e quanto è nitido.
  • Visualizzazione: schermo intero, zoom e ricerca per i diagrammi più grandi della pagina.
  • Versione di Mermaid: i tipi di diagramma più nuovi chiedono una versione recente.
  • Prezzo per il tuo numero di utenti, e che cosa succede ai diagrammi se la licenza scade.

Vellnar Diagrams salva il codice nella pagina, non chiede nessun permesso, non fa connessioni esterne, mette un’immagine vettoriale nei PDF e disegna con Mermaid 12.3. Se la licenza scade, i diagrammi restano visibili e si ferma solo la modifica.

Lo abbiamo confrontato con altre sei app, con fatti datati e con i casi in cui conviene l’altra app:

Tutti i tipi di diagramma

Ogni pagina dice a che cosa serve il diagramma, con codice di esempio e i modelli inclusi nell’app.

Domande frequenti

Il diagramma compare quando la pagina viene esportata in PDF?

Sì. Vellnar Diagrams mette nel PDF un’immagine vettoriale del diagramma, su una pagina o a dimensione reale, come scegli nelle impostazioni del diagramma. Un’esportazione in Word contiene il codice del diagramma.

Chi non conosce Mermaid può usarlo?

Può leggere, aprire, ingrandire ed esportare ogni diagramma senza conoscere il codice. Per scriverne uno, la maggior parte delle persone parte da un modello e cambia le etichette; l’anteprima mostra subito ogni modifica.

Che cosa chiede l’app al nostro sito Confluence?

Niente. Vellnar Diagrams non chiede nessun permesso e gira su Atlassian. La pagina sicurezza ha i dettagli.

Possiamo provarlo prima?

Atlassian vende l’app con 30 giorni di prova gratuita. Puoi anche provare l’editor su questo sito, senza installare nulla.