Markdown user journey map maker

Chart a user journey step by step. Score each task in a Mermaid journey block to show where a workflow delights or frustrates people.

Mermaid user journey syntax

A user journey is a title and a list of steps grouped into sections. Each step has a name, a score from one to five, and the people involved. Here is each piece you can write.

Steps and scores

Write a step, a colon, a score from 1 to 5, then who does it. A higher score is a happier step.

You write

journey
  title My working day
  section Morning
    Wake up : 3 : Me
    Commute : 2 : Me
  section Office
    Stand-up : 4 : Me, Team
    Write code : 5 : Me

You get

Several people

List more than one person after the score, separated by commas.

You write

journey
  title Release day
  section Ship
    Review : 3 : Dev, Lead
    Deploy : 4 : Dev, Ops

You get

Cheat sheet

Write this	You get
`journey`	Start a user journey
`title Text`	Journey title
`section Name`	Group of steps
`Task : 3 : Me`	A step scored 1 to 5 with who does it
`Task : 4 : A, B`	A step with several people