Diagramma con ChatGPT: lui lo scrive, qui viene disegnato

Che cosa abbiamo verificato davvero

Il 28 agosto 2026, in una conversazione in inglese, abbiamo chiesto a un ChatGPT non autenticato un diagramma di registrazione già disegnato e scaricabile in PNG o SVG. La risposta:

“Image generation requires logging in. Once you’re logged in, I can generate the rendered signup flowchart for you.”

In sostanza: la generazione di immagini richiede l’accesso; una volta effettuato, il diagramma disegnato sarebbe stato prodotto.

Poi abbiamo chiesto alla stessa conversazione solo il codice Mermaid, nient’altro. Ha restituito subito il diagramma completo qui sopra: sintassi corretta, nodi decisionali sensati, ritorni indietro sui rami di errore. Senza account, senza attesa, senza quota.

È tutta qui la questione. La parte difficile — tradurre un processo confuso in un grafo corretto, con i nodi e gli archi giusti — è proprio quella che fa gratis. La parte facile, disegnarlo, è quella che mette dietro l’accesso.

Richieste che restituiscono codice utilizzabile

• Imponi il formato. «Dammi solo il codice Mermaid, nient’altro» evita tre paragrafi di spiegazione intorno e il ricorso allo strumento per le immagini.
• Indica il tipo di diagramma. flowchart TD per i processi, sequenceDiagram per le chiamate tra servizi, erDiagram per i modelli di dati, gantt per le pianificazioni. Dirlo subito evita di ricevere un diagramma di flusso quando serviva una sequenza.
• Dagli il materiale vero. Incolla la funzione, la migrazione o la procedura così come sono e chiedi il diagramma di ciò che c’è scritto. Diagrammare codice esistente riesce molto più fedele che diagrammarne una descrizione.
• Restituiscigli gli errori di sintassi. Se qui la resa fallisce, ricopia il messaggio di errore nella chat. Gli errori di sintassi Mermaid sono l’unica categoria di errore che corregge in modo affidabile al primo tentativo.

In italiano tocca lavorare sulla documentazione inglese

Una differenza concreta rispetto ad altre lingue: la pagina di GitHub sulla creazione dei diagrammi Mermaid non esiste in italiano. Il 6 settembre 2026 abbiamo interrogato docs.github.com nelle varie lingue: le versioni tedesca, francese, spagnola, giapponese e coreana rispondono 200, mentre docs.github.com/it/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams risponde 404. Chi lavora in italiano fa riferimento alla pagina inglese — dove la sintassi è comunque una sola riga: un blocco di codice con l’identificatore di linguaggio mermaid, che GitHub disegna dentro README, issue, pull request e wiki.

Le etichette, invece, restano libere. ChatGPT tende a restituirle in inglese perché gli esempi Mermaid lo sono, ma un’etichetta è testo: tra virgolette — A["L’utente apre la pagina di registrazione"] — accenti, apostrofi, spazi e punteggiatura funzionano senza accorgimenti. Il primo modello qui sopra è esattamente questo: lo stesso diagramma, etichettato in italiano.

Perché il codice batte comunque l’immagine

Anche se ChatGPT ti consegnasse un PNG già pronto, non ti servirebbe. Un diagramma Mermaid è testo: sta nel repository accanto al codice che descrive, compare come diff leggibile in una pull request, viene disegnato nativamente in un README e si aggiorna cambiando una riga. Un’immagine è congelata — per spostare un riquadro si ricomincia da capo.

Da qui in poi: creare un diagramma di flusso, diagramma UML online, diagramma di Gantt, editor Mermaid, diagramma ad albero delle probabilità.

Comportamento di ChatGPT verificato il 28 agosto 2026 in una conversazione non autenticata, in inglese; limiti dei piani letti su chatgpt.com/it-IT/pricing e copertura linguistica della documentazione GitHub misurata il 6 settembre 2026. Questi prodotti cambiano spesso: da leggere come una fotografia datata, non come una regola permanente.