How do I add Mermaid diagrams to markdown?

Mermaid diagrams let you create flowcharts, sequence diagrams, and more using text-based syntax in markdown.

**Basic syntax:**

flowchart TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Do something]
    B -->|No| D[End]

**Where Mermaid works:** - **markshare** - Full support, renders automatically - **GitHub** - Supported in markdown files - **GitBook** - Supported - **Notion** - Not supported natively - **Google Docs** - Not supported

**Diagram types:** - Flowcharts - Sequence diagrams - Class diagrams - State diagrams - Entity-relationship diagrams - Gantt charts

Use our free Mermaid Editor to create and preview diagrams before adding to your markdown.