Mermaid vs draw.io
People think Mermaid and draw.io are two apps for the same job, and they are not. In draw.io you drag every box into place by hand. In Mermaid you write lines of text, and it places the boxes for you. A Mermaid diagram lives in a Markdown file beside the code, so it gets reviewed and fixed like code. draw.io wins when the exact layout matters.
Mermaid
Diagrams written as short lines of text. The tool draws the picture for you.
Mermaid is a way to make diagrams by writing short lines of text. You type a line like A --> B, and Mermaid draws box A with an arrow to box B. It can draw flowcharts, sequence diagrams, Gantt charts, class diagrams and many more. GitHub, GitLab and many note apps draw Mermaid inside Markdown files. Because the diagram is text, a change shows up in a code review like any other line.
draw.io
A free tool for neat diagrams. You drag shapes from libraries and save the file anywhere.
draw.io is a free diagramming tool for the web and the desktop. You drag shapes from big libraries, for flowcharts, networks, cloud setups and UML. It saves your files where you choose, such as your own computer or a cloud drive. A draw.io file is XML text, so it can live in Git beside your code. For a time it was also called diagrams.net.
In one line
- Mermaid
- Diagrams written as short lines of text. The tool draws the picture for you.
- draw.io
- A free tool for neat diagrams. You drag shapes from libraries and save the file anywhere.