Diagramma di Gantt
Pianifica i progetti su una linea temporale chiara
Che cos’è un Diagramma di Gantt?
Un diagramma di Gantt dispone le attività su un calendario con durate, dipendenze e milestone. È lo standard del project management per mostrare chi fa cosa, quando, e cosa dipende da cosa.
I diagrammi di Gantt compaiono nei comitati di pilotaggio e nei piani di rilascio, dove il pubblico vuole date più che logica. Scritti come testo, guadagnano un vantaggio insolito: il piano viene rivisto nella stessa pull request del lavoro che descrive. Il loro punto debole è che invecchiano male — un Gantt è un’istantanea di intenzioni, e niente in Mermaid ti avverte che ha smesso di corrispondere alla realtà tre settimane fa.
Esempio dal vivo
gantt
title Product Launch
dateFormat YYYY-MM-DD
section Design
Wireframes :a1, 2026-01-05, 10d
UI design :a2, after a1, 14d
section Build
Backend API :b1, 2026-01-12, 21d
Frontend :b2, after a2, 18d
section Launch
Beta testing :c1, after b2, 10d
Go live :milestone, after c1, 0dQuando usarlo
Errori frequenti
dateFormat non corrisponde alle tue date
Con dateFormat YYYY-MM-DD, un’attività che inizia il 05/01/2026 non viene rifiutata: viene interpretata come un’altra data e il grafico si allunga silenziosamente su interi mesi. Allinea i due, oppure dichiara dateFormat DD/MM/YYYY.
Due punti dentro il nome dell’attività
Tutto ciò che precede i primi due punti è l’etichetta, quindi Phase 1: discovery :a1, 2026-01-05, 7d disegna un’attività chiamata «Phase 1» e scarta in silenzio il resto del nome. Nei nomi delle attività usa un trattino.
Riutilizzare un id di attività
Gli id devono essere unici. Quando due attività ne condividono uno, after si risolve sull’ultima dichiarazione, e un’attività dipendente salta avanti di settimane senza il minimo errore. Prefissa gli id per sezione — d1, b1, l1 — per tenerli distinti.
Sintassi di base
gantt
dateFormat YYYY-MM-DD
section Phase 1
Task A :a1, 2026-01-01, 7d
Task B :after a1, 5ddateFormat YYYY-MM-DD axisFormat %d/%mdateFormat dice a Mermaid come leggere le date che scrivi; axisFormat controlla come vengono stampate lungo l’asse. I due sono indipendenti e spesso diversi.
Backend API :active, b1, 2026-01-12, 21dUna riga di attività è etichetta, poi tag, id, inizio e durata. I tag sono done, active, crit e milestone; l’inizio può essere una data oppure after b1.
excludes weekends todayMarker stroke-width:4px,stroke:#e11excludes toglie dal calendario lavorativo i fine settimana o date specifiche. todayMarker cambia lo stile della linea della data odierna, e todayMarker off la nasconde del tutto.
section Launch Go live :milestone, m1, after c1, 0dLe sezioni raggruppano le attività per filone di lavoro, ciascuna con la propria fascia di colore. Una milestone con durata zero viene disegnata come un rombo invece che come una barra.
Domande su questo diagramma
Le attività possono dipendere l’una dall’altra?
Sì — usa «after taskId» per concatenare le attività, e le milestone per segnare le date chiave. Le sezioni raggruppano le attività per filone di lavoro o per team.
Un Gantt testuale è meglio di uno strumento di project management?
Per la comunicazione, sì: vive nella tua documentazione, si versiona con git e si aggiorna in pochi secondi. Per la gestione delle risorse, affiancalo al tuo strumento di PM.
Come condivido un diagramma di Gantt con chi non usa Mermaid?
Esporta in PNG per slide ed email, in SVG per tutto ciò che verrà ingrandito, oppure pubblica il diagramma come pagina pubblica e manda il link: il link continua a mostrare la versione corrente anche dopo che hai aggiornato il piano.
Un diagramma di Gantt Mermaid può mostrare i responsabili o l’avanzamento in percentuale?
No. Non esiste una colonna delle risorse né una barra di avanzamento; le uniche informazioni di stato sono i tag done, active e crit su un’attività. Tieni la pianificazione delle capacità nel tuo strumento di project management e usa il grafico per comunicare.
Mermaid disegna frecce tra le attività dipendenti?
No. Scrivere after b1 imposta la data di inizio di un’attività ma non disegna alcuna freccia di dipendenza, quindi il legame resta invisibile al lettore. Dillo nel nome dell’attività, oppure usa un diagramma di flusso quando il messaggio è il grafo delle dipendenze.
Come segno la data di oggi sul grafico?
Mermaid disegna un marcatore sulla data corrente per impostazione predefinita, presa dall’orologio di chi renderizza il diagramma. todayMarker stroke-width:4px,stroke:#e11 ne cambia lo stile e todayMarker off lo rimuove — utile quando il grafico è un modello riutilizzabile invece di un piano attivo.
Diagramma di Gantt o un altro tipo di diagramma?
Diagramma di Gantt o linea temporale?
Il Gantt serve per il lavoro che deve ancora accadere: durate, dipendenze, percorso critico. La linea temporale serve per eventi che hanno una data ma non una durata — release, incidenti, storia dell’azienda. Se nel tuo elenco nulla ha una lunghezza, ti serve una linea temporale.
Diagramma di Gantt o diagramma di flusso?
Entrambi descrivono un piano. Il diagramma di flusso conserva le ramificazioni — che cosa succede se l’audit fallisce — e ignora il calendario; il Gantt conserva il calendario e appiattisce ogni ramo in un unico percorso nominale. Ai comitati serve il Gantt, ai team di delivery spesso entrambi.
Crea ora il tuo Diagramma di Gantt
Descrivilo in linguaggio naturale — l’IA scrive il codice Mermaid per te.
Apri Mermaid Studio