journeyv0.9.4

What is a User journey diagram?

Touchpoints rated by satisfaction.

Open in editor →Ready-to-use templates

journey

When to use it

Use a User journey when…

UX research artifacts

Onboarding flow scoring

Any process with subjective satisfaction

Syntax basics

The minimal syntax

Copy this and you have a working user journey. Build from here.

journey.mmd

journey
    title First-week experience
    section Sign up
      Land on homepage: 4: User
      Create account: 3: User
    section First diagram
      Pick template: 5: User
      Render flowchart: 5: User
      Share link: 4: User, Teammate

Common patterns

Patterns worth memorizing

Multi-actor steps

`task: 4: User, Barista` — list every actor involved at that step.

Score = emoji proxy

Scores 1–5 map to emoji-like dots; treat them as ordinal, not interval.

Sections as phases

Group steps by `section` to keep the chart legible past ~6 rows.

Common gotchas

The things that will trip you up

Mermaid silently ignores misspellings — these are the failures we see most.

01
Section names show on the y-axis; keep them short.
02
Scores are integers — fractional scores (3.5) are rounded.
03
No way to add notes per step; use a flowchart for richer annotation.

Related diagram types