Générateur de diagrammes de séquence
Cartographiez qui appelle quoi et dans quel ordre. Écrivez quelques lignes de Mermaid et obtenez un diagramme de séquence propre de vos appels API, poignées de main auth ou flux de messages — affiché localement, jamais envoyé.
One step per line. Indent two spaces to branch beneath the line above.
Les diagrammes de séquence rendent le timing évident
Un diagramme de séquence se lit de haut en bas comme le temps et de gauche à droite comme les participants, donc c'est la façon la plus claire de documenter une interaction : une connexion OAuth, un rappel de webhook, une chaîne d'appels microservices, ou une tentative sujette aux races. Les flèches solides sont les demandes, les flèches en pointillés sont les réponses, et les notes signalent les parties délicates.
Parce que chaque message est une ligne de texte, le diagramme reste synchronisé avec la réalité — mettez à jour la ligne, rafraîchissez, c'est fait. Il appartient directement à la doc API ou à la RFC de conception.
Conçu pour les docs de conception et les RP
Collez le bloc Mermaid directement dans une demande de tirage GitHub ou une doc de conception et les examinateurs verront le flux s'afficher en ligne. Ou exportez un SVG pour un wiki et un PNG pour une diapositive. Tout est généré sur votre appareil, donc même un flux interne non publié ne quitte jamais votre machine.
Questions fréquemment posées
Comment créer un diagramme de séquence à partir de texte ?
Commencez par « sequenceDiagram », déclarez vos participants, puis ajoutez un message par ligne comme « A->>B: request ». Le diagramme s'affiche en direct et vous pouvez l'exporter en SVG ou PNG.
Quelle est la différence entre une flèche pleine et en pointillés ?
Une flèche pleine (« ->> ») est un appel ou une demande ; une flèche en pointillés (« -->> ») est le message de réponse ou de retour. Les utiliser de manière cohérente rend les paires demande/réponse évidentes.
Puis-je montrer des alternatives, des boucles et des notes ?
Oui. Utilisez « alt … else … end » pour les branches, « loop label … end » pour les étapes répétées, et « Note over A,B: text » pour les annotations. Consultez l'antisèche ci-dessus.
Mon diagramme de séquence est-il envoyé ?
Non. Il s'affiche localement dans votre navigateur avec Mermaid, donc le texte du diagramme — y compris les détails internes de l'API — ne quitte jamais votre appareil.
Puis-je numéroter automatiquement les messages ?
Oui — ajoutez la ligne « autonumber » directement après « sequenceDiagram » et chaque message obtient un numéro séquentiel, ce qui est pratique pour référencer les étapes dans une doc.