Choosing the Right Diagram
| Diagram | Main Purpose | Starting Syntax |
|---|---|---|
| Flowchart | Processes and decisions | flowchart LR |
| Sequence | Interactions over time | sequenceDiagram |
| State | System states | stateDiagram-v2 |
| Class | OOP structures | classDiagram |
| ER | Database relationships | erDiagram |
| Gantt | Project timelines | gantt |
| Kanban | Task tracking | kanban |
| Pie | Part-to-whole data | pie |
| XY Chart | Bar/line data | xychart-beta |
| Requirement | System requirements | requirementDiagram |
| GitGraph | Git history | gitGraph |
| Architecture | Infrastructure topology | architecture-beta |
| Packet | Protocol fields | packet-beta |
A Learning Path
A practical chronological learning order is:
Step 1 — Learn the Code Block
flowchart LR
A --> B
Step 2 — Learn Nodes and Edges
flowchart LR
A[Start] --> B{Decision}
Step 3 — Learn Flowchart Logic
flowchart TD
A --> B{Valid?}
B -->|Yes| C[Continue]
B -->|No| D[Stop]
Step 4 — Learn Subgraphs
flowchart TB
subgraph Frontend
A --> B
end
subgraph Backend
C --> D
end
B --> C
Step 5 — Learn Time-Based Interaction
sequenceDiagram
User->>Server: Request
Server-->>User: Response
Step 6 — Learn System State
stateDiagram-v2
[*] --> Idle
Idle --> Running
Running --> [*]
Step 7 — Learn Data Models
erDiagram
USER ||--o{ POST : writes
Step 8 — Learn Object Models
classDiagram
Animal <|-- Dog
Step 9 — Learn Project and Data Charts
gantt
title Project
dateFormat YYYY-MM-DD
Design :2026-01-01, 2d
pie
title Example
"A" : 60
"B" : 40
Step 10 — Learn Advanced Engineering Diagrams
Move to:
- GitGraph
- Requirement diagrams
- Architecture diagrams
- Packet diagrams
- advanced styling
- layouts
- configuration
- interactivity