Generatore di diagrammi di sequenza
Mappa chi chiama cosa e in quale ordine. Scrivi alcune righe di Mermaid e ottieni un diagramma di sequenza pulito delle tue chiamate API, handshake di autenticazione o flussi di messaggi — visualizzato localmente, mai caricato.
One step per line. Indent two spaces to branch beneath the line above.
I diagrammi di sequenza rendono ovvi i tempi
Un diagramma di sequenza legge da cima a fondo come tempo e da sinistra a destra come partecipanti, quindi è il modo più chiaro per documentare un'interazione: un accesso OAuth, un callback di webhook, una catena di chiamate di microservizi, o una ripetizione soggetta a race condition. Le frecce solide sono richieste, le frecce tratteggiate sono risposte, e le note sottolineano i punti delicati.
Poiché ogni messaggio è una riga di testo, il diagramma rimane sincronizzato con la realtà — aggiorna la riga, risemina, fatto. Appartiene direttamente al documento API o alla RFC di design.
Costruito per documenti di design e PR
Incolla il blocco Mermaid direttamente in una pull request di GitHub o in un documento di design e i revisori vedono il flusso visualizzarsi inline. O esporta un SVG per una wiki e un PNG per una diapositiva. Tutto viene generato sul tuo dispositivo, quindi anche un flusso interno non divulgato non lascia mai il tuo computer.
Domande frequenti
Come creo un diagramma di sequenza dal testo?
Inizia con "sequenceDiagram", dichiara i tuoi partecipanti, quindi aggiungi un messaggio per riga come "A->>B: richiesta". Il diagramma si visualizza in tempo reale e puoi esportarlo come SVG o PNG.
Qual è la differenza tra una freccia solida e una tratteggiata?
Una freccia solida ("->>") è una chiamata o una richiesta; una freccia tratteggiata ("-->>") è il messaggio di risposta o di ritorno. Usarle coerentemente rende ovvie le coppie richiesta/risposta.
Posso mostrare alternative, loop e note?
Sì. Usa "alt … else … end" per i branch, "loop label … end" per i passaggi ripetuti, e "Note over A,B: testo" per le annotazioni. Consulta il foglio di aiuto sopra.
Il mio diagramma di sequenza viene caricato?
No. Si visualizza localmente nel tuo browser con Mermaid, quindi il testo del diagramma — inclusi i dettagli dell'API interna — non lascia mai il dispositivo.
Posso numerare automaticamente i messaggi?
Sì — aggiungi la riga "autonumber" subito dopo "sequenceDiagram" e ogni messaggio ottiene un numero sequenziale, che è utile per fare riferimento ai passaggi in un documento.