# Diagramming Software

> Tools for neat charts of boxes and arrows. Apps where you drag shapes, like draw.io. And tools where you type the chart, like Mermaid.

**Course:** [Figma and Design Tools](https://learn.benibix.com/learn/design-design-tools)  
**Time:** 12 min

**After this lesson you can:**

- Pick drag-and-drop or text diagrams
- Write a two-box Mermaid diagram
- Keep a diagram next to the code

## Two ways to draw a diagram: drag it or write it

Diagramming software draws neat charts of boxes, lines and labels, such as flowcharts and maps of a system. There are two kinds. In one, you drag shapes onto a page and the lines stay stuck to them. In the other, you type a few lines of text and the tool draws the picture.

draw.io is a free drag tool for the web and the desktop. It has big libraries of shapes, and it saves the file wherever you choose. The file is plain text inside, so it can sit in the same folder as a project's code and be checked like code.

Lucidchart is a drag tool that runs in the browser. Several people can edit one diagram at once and leave comments. It can build a chart from a spreadsheet. Your diagrams are kept in its cloud, with a free plan that has limits.

Mermaid is the best known text tool. You type a line like A --> B, and it draws box A with an arrow to box B. GitHub, GitLab and many note apps draw Mermaid inside their pages. Change two words of text, and the picture redraws itself.

PlantUML is an older text tool. You write lines between @startuml and @enduml, and it draws the picture. It covers the common software diagrams, like the steps between a shop and a bank. Structurizr goes further. You write one model of a system, and it draws several diagrams from it. Rename a part once, and every diagram changes.

Text diagrams win when the diagram lives next to code. A change to the diagram shows up in a review like any other line, and nobody hunts for the newest picture. Drag tools win when the reader is not a coder, or the layout needs a careful hand.

The common mistake is a diagram nobody updates. A neat picture of last year's system is worse than none, because people trust it. Keep diagrams where the work happens, and change them in the same step as the thing they show.

![Three panels, each making the same two boxes, Shop above Pay, joined by an arrow. Sketch by hand, like Excalidraw: wobbly boxes and a curved arrow. Drag shapes, like draw.io: a strip of shapes on the left and two neat boxes joined by a straight line. Write text, like Mermaid: two lines of code with an arrow down to the two boxes it draws.](https://learn.benibix.com/diagrams/des-diagram-tools.svg)

```mermaid
flowchart TB
  A[Shop] --> B[Pay]
```

## Five diagram tools

| Tool | How you make it | Where the file lives |
| --- | --- | --- |
| draw.io | Drag shapes | Wherever you save it |
| Lucidchart | Drag shapes | Lucidchart's cloud |
| Mermaid | Write text | In your notes or code |
| PlantUML | Write text | In your notes or code |
| Structurizr | Write one model, get many views | In your code |

## Which kind to pick

1. **Drag shapes.** Pick one when the readers do not code, or each box needs a careful hand.
2. **Write text.** Pick one when the chart lives next to code and should be checked along with it.
3. **One model, many views.** Pick it when one big system needs a few charts that must always match.

### Example: A login flow that redraws itself

Emma keeps a Mermaid chart of the 6 steps to log in to her app. It sits in the notes for her project on GitHub.

When a new step is added, she types one more line. The picture redraws, and her teammate sees the change in the same review as the code.

**Words in this lesson:** [Diagramming Software](https://learn.benibix.com/term/design/diagramming-software), [draw.io](https://learn.benibix.com/term/design/drawio), [Lucidchart](https://learn.benibix.com/term/design/lucidchart), [Mermaid](https://learn.benibix.com/term/design/mermaid), [PlantUML](https://learn.benibix.com/term/design/plantuml), [Structurizr](https://learn.benibix.com/term/design/structurizr)

> **The one difference.** A drag tool gives you a picture you place by hand. A text tool gives you a picture drawn from words, so it changes as easily as the words do.

**Question:** When is a text tool like Mermaid the better choice?

**Answer:** When the diagram lives beside code and changes with it. A text diagram is reviewed and changed like any other line of code. That keeps it in step with the system it shows.

---

Source: https://learn.benibix.com/learn/design-design-tools/diagramming-software
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
