MERMAIDEDITOR/Learn
Learn

Practical guides for the diagrams-as-code workflow.

Short, opinionated articles. No marketing fluff. Each one is a single page you can read on the train.

startok?retrycommitenddone
flowchart7 min read

Flowchart best practices

Direction, density, and the secret of when to switch from TD to LR.

UserAPIDBGET /meSELECT…row200 OK
sequence5 min read

Sequence vs flowchart: which to pick

Time order vs branching logic — a five-minute decision guide.

userWeb App[Container]Auth0[SaaS]APIDatabase
c49 min read

C4 architecture in three diagrams

Context, container, component — and why you almost never need the fourth.

CUSTOMERid PKemailcreated_atPRODUCTsku PKtitlepriceORDERid PK · cust_id FKplacescontains
er6 min read

ER modeling for code reviewers

Reading crow's-foot like a database engineer.

w1w2w3w4w5researchdesignbuild · apibuild · uiqalaunch
gantt4 min read

Gantt vs timeline: dependencies are the test

If a task has a predecessor, you need Gantt. Otherwise, timeline wins.

IdleLoadingReady
state8 min read

Modeling state machines without a library

How a stateDiagram-v2 can replace a 200-line redux reducer.