
Introducing Mermaid Sequence Diagrams
Aykut Saraç
• March 7, 2026
ToDiagram now supports Mermaid Sequence Diagrams.
Sequence diagrams are useful when the order of messages matters. They help you explain how a request moves between people, services, and systems over time.
If you already use Mermaid in docs or pull requests, you can now use the same sequence syntax directly in ToDiagram.
Where This Helps
- API and auth flows: Show request/response order clearly.
- Microservice communication: Trace calls across services.
- Event-driven workflows: Document async handoffs and callbacks.
Example
sequenceDiagram
participant Client
participant APIGateway as API Gateway
participant AuthService as Auth Service
Client->>APIGateway: Request /data
APIGateway->>AuthService: Validate Token
AuthService-->>APIGateway: Token Valid
APIGateway-->>Client: 200 OK (Data)
Mermaid sequence diagram rendered in ToDiagram
How To Use It
- Open the ToDiagram editor.
- Select Mermaid format.
- Paste your
sequenceDiagram.
