New: TypeFire 7 and TypeFire for Chrome 2.0.
Free · Live examples · No sign-up

Markdown flowcharts with Mermaid, written as text

A Mermaid flowchart is a list of boxes and the arrows between them. Pick a direction, give each box an id and a label, and draw arrows with -->. The example below is live, so change a word and watch it redraw.

Free in your browser. On a Mac, TypeFire opens every .md file like this, right from Finder.Download free for Mac

Flowchart.md
FileEditViewInsertFormatHelp
Flowchart.md

A Mermaid flowchart

YesNoYesNoNew ticketBillingquestion?Send tobillingUrgent?Page theon-callAdd to thequeueReply sent
YesNoYesNoNew ticketBillingquestion?Send tobillingUrgent?Page theon-callAdd to thequeueReply sent

Try this

  • Change LR to TD to draw it top to bottom.
  • Change [Send to billing] to (Send to billing) for rounded corners.
  • Add G --> H[Close the ticket] on a new line.
Loading the editor…Your files stay in your browser
  • Your files never leave your browser
  • Free, no sign-up
  • Download as Markdown, Word, a web page or a PDF

This editor comes from TypeFire, free for Mac

Your whole folder of Markdown notes in tabs, Quick Look previews in Finder, plus a text expander and a clipboard manager.

How it works

Write a Mermaid flowchart

  1. 01

    Pick a direction

    Start with flowchart TD for top to bottom, or LR for left to right. BT and RL flip them.

  2. 02

    Add boxes

    Write an id and a label: A[New ticket]. The brackets set the shape, so {Urgent?} draws a decision.

  3. 03

    Join them

    A --> B draws an arrow. Put text on it with A -- Yes --> B or A -->|Yes| B.

Mermaid flowchart text on the left becomes a drawn ticket triage flowchart with two decision diamonds
Free for Mac and Chrome

Diagrams in your notes? Get TypeFire.

On the Mac, every Mermaid block in your notes draws in TypeFire's colors. Open one full window to zoom in, resize it, link a box to another note, and save it as SVG or PNG.

Download free for MacAdd to Chrome7 day Pro trial, no card required.

Free text expander, markdown notes and a clipboard manager. $18 once for unlimited clips, notes sync and AI prompts.

At a glance

Shapes and arrows at a glance

The brackets around a label set the shape. The dashes set the line.

Drawn from the example above

A[Text]
A box
A(Text)
A box with round corners
A([Text])
A pill shape
A{Text}
A decision diamond
A[(Text)]
A database cylinder
A((Text))
A circle
A --> B
An arrow
A --- B
A line with no arrowhead
A -.-> B
A dotted arrow
A ==> B
A thick arrow
A -- Yes --> B
An arrow with a label
What it does

Flowchart rules worth knowing

  1. Ids and labels are different

    Use a short id like A everywhere, and the label only once. The label is what people see.

  2. Quote odd labels

    A label with brackets or symbols in it goes in quotes: A["Price (USD)"].

  3. Group with subgraphs

    Wrap steps in subgraph Billing ... end to draw a box around them with a title.

  4. Comments are allowed

    A line that starts with %% is ignored, so you can leave notes for the next person.

A Markdown document in the editor with the flowchart's Mermaid text and the drawn chart side by side
Take it further

The same editor, without the browser tab

This editor comes from TypeFire, a free app for Markdown notes, a text expander and a clipboard manager. Here it works on the files you open. In the app, it opens your whole folder.

TypeFire for Mac with several Markdown notes open in one tab bar

TypeFire for Mac

  • Press Space on any .md file in Finder and read it rendered, with Quick Look.
  • Open a folder of Markdown, an Obsidian vault included, with tabs, search and links.
  • A text expander and a clipboard history in the same free app.
In a browser email, typing thx and a space expands into a whole thank-you reply

TypeFire for Chrome

  • This editor in its own tab, one click from the toolbar.
  • Your folder of .md notes in tabs, with search and links.
  • A text expander and your clipboard history on every site.

Frequently asked questions

Still not answered?

Put a Mermaid flowchart in a code block marked mermaid.

Start with flowchart TD, then one line per arrow, like A[Start] --> B[Finish]. Apps that draw Mermaid show it as a diagram.

Use curly braces for a diamond, B{Approved?}, then label the arrows leaving it: B -- Yes --> C and B -- No --> D.

Change the word after flowchart: TD or TB for top to bottom, LR for left to right, RL for right to left and BT for bottom to top.

Both start a flowchart. flowchart is the newer keyword and supports more shapes and features, so use it for new diagrams.

Use <br> inside a quoted label: A["First line<br>Second line"].

In TypeFire for Mac, write the label as a quoted note link, A["[[Pricing]]"].

Clicking it opens that note, and the link shows in its backlinks and follows a rename.

Flowcharts in your own notes

TypeFire for Mac draws flowcharts in your notes, lets you zoom in, resize them and link a box to another note. Free.

Download free for MacAdd to ChromeSee what $18 adds7 day Pro trial, no card required.

Free text expander, markdown notes and a clipboard manager. $18 once for unlimited clips, notes sync and AI prompts.

your clips your snippets