Add a Diagram to a README

Create diagrams GitHub renders natively in your README.

Hakuna kuingia kinachohitajika

Diagram code

Preview

Start typing to see your diagram…

💡 Write diagrams in Mermaid syntax — flowcharts, sequence diagrams, Gantt charts, class diagrams, and more — and export as SVG or PNG. Rendering happens entirely in your browser; nothing is uploaded.

GitHub tips

📖

GitHub renders Mermaid in Markdown — paste your code in a ```mermaid block and it shows inline.

🔧

Use this editor to get the syntax right with a live preview before committing.

🖼️

If you need an image instead, export SVG or PNG here.

🔒

Everything runs in your browser.

Jinsi Inavyofanya Kazi

Ingiza

Enter your data into the tool above. Everything stays local to your browser.

Chakata

The tool processes your data instantly in your browser using JavaScript. No server, no waiting.

Pakua

Get your result instantly. Nothing is stored after you leave the page — complete privacy.

Kwa nini utumie yetu?

✓Bure kabisa — bila gharama zilizofichwa, kamwe

✓Hakuna akaunti, barua pepe, au kuingia kinachohitajika

✓Faili hazitoki kwenye kifaa chako kamwe

✓Hakuna kikwazo cha ukubwa wa faili kabisa

✓Hakuna alama za maji kwenye matokeo yoyote

Also check out…

🔀

Make a Flowchart

Create a flowchart from text and export it as an i

↔️

Draw a Sequence Diagram

Diagram how systems or people interact over time.

📆

Build a Gantt Chart

Lay out a project timeline as a Gantt chart from t

🧱

Create a Class Diagram

Diagram classes and their relationships for softwa

Maswali Yanayoulizwa Mara Kwa Mara

Back to Mermaid Diagram Editor