Mind map

Mind maps are for the part of thinking that happens before structure exists. The rule is one idea per branch and no editing while you generate, which is easier when adding a branch costs one line of text.

Capable renders Mermaid mind maps from indented text, so the map lays itself out while you type.

#When to reach for one

• Brainstorming, alone or in a workshop.

• Taking notes on something with a shape you do not yet know.

• Planning a document or talk before writing it.

#How to draw it in Capable

#A worked example

A mind map generated from indentation:

The source, which you can paste into a new diagram and edit:

mindmap
  root((Documentation rebuild))
    Audience
      New users
      Existing admins
      Evaluators
    Structure
      By task
      By diagram type
      Reference
    Content
      Screenshots
      Worked examples
      Troubleshooting
    Constraints
      One person writing
      Ship in six weeks

#A few things that catch people out

• Generate first, organise later. Editing while brainstorming kills the brainstorm.

• One idea per branch. Sentences on branches are notes, not a mind map.

• Three levels is usually the limit before it becomes a document in disguise.

#Related

Generate first. Organise second.