What a Mermaid quadrant chart is for
A quadrant chart places items on two axes split into four quadrants, like an effort versus impact matrix or a Gartner-style map. Coordinates run from 0 to 1 on each axis.
Quadrant Chart syntax
| Syntax | Meaning |
|---|---|
x-axis Low --> High |
Labels for both ends of the x axis |
y-axis Low --> High |
Labels for both ends of the y axis |
quadrant-1 Text |
Top right; 2 is top left, 3 bottom left, 4 bottom right |
Item: [0.3, 0.6] |
A point at x 0.3, y 0.6 (0 to 1) |
Basic example
quadrantChart
title Effort vs impact
x-axis Low effort --> High effort
y-axis Low impact --> High impact
quadrant-1 Plan carefully
quadrant-2 Do first
quadrant-3 Maybe later
quadrant-4 Avoid
Dark mode: [0.25, 0.4]
SSO: [0.7, 0.85]
CSV export: [0.15, 0.7]
Rewrite in Rust: [0.9, 0.3]
Open this example in the Mermaid editor
Common mistakes
- Quadrants are numbered counterclockwise starting top right, like in math, not reading order.
Use it in Markdown
```mermaid
quadrantChart
title Effort vs impact
x-axis Low effort --> High effort
y-axis Low impact --> High impact
quadrant-1 Plan carefully
quadrant-2 Do first
quadrant-3 Maybe later
quadrant-4 Avoid
Dark mode: [0.25, 0.4]
SSO: [0.7, 0.85]
CSV export: [0.15, 0.7]
Rewrite in Rust: [0.9, 0.3]
```
GitHub, GitLab, Azure DevOps, Obsidian, Notion and docs generators such as Docusaurus and MkDocs (with a plugin) draw fenced mermaid blocks. Check it locally in the Markdown preview.
Other Mermaid diagrams
- Mermaid flowchart syntax
- Mermaid sequence diagram syntax
- Mermaid class diagram syntax
- Mermaid state diagram syntax
- Mermaid er diagram syntax
- Mermaid gantt chart syntax
- Mermaid pie chart syntax
- Mermaid mindmap syntax
- Mermaid timeline syntax
- Mermaid git graph syntax
- Mermaid user journey syntax
- Mermaid xy chart syntax
Sources
Spotted a mistake? Email hello@devtoolsmith.com and we’ll fix it.
Frequently asked questions
How do I start a Mermaid quadrant chart?
Begin the diagram with the keyword quadrantChart on its own line, then add one statement per line. In Markdown, wrap the whole diagram in a fenced code block with the language mermaid so GitHub, GitLab and most docs sites draw it.
How do I export a Mermaid quadrant chart as an image?
Paste the diagram into the editor on this page and use SVG or PNG above the preview. SVG stays sharp at any size and can be edited further; PNG is exported at twice the screen resolution for slides and documents. Nothing is uploaded.