Skip to main content
A mindmap document is a map. The document’s title is the centre, main branches radiate from it, and topics nest underneath. Reach for it when the shape of the thinking matters as much as the words: a strategy you are pulling apart, a customer you are profiling, an offering you are scoping.

What it looks like underneath

Each heading is a main branch, and the list items under it are its topics, nested by indent. The title is not in the text: it is the document’s own title.

Creating a map

In the sidebar, choose New document, then Mindmap, from a folder’s ⋯ menu. See Creating one. The name you give it becomes the centre of the map. Choose Add your first topic to start. Or ask your agent: “Turn our positioning notes into a mind map, with the pillars as branches and the proof points underneath each.” You can also ask it to turn an existing board or tracker into a map.

Working with a map

The map fills the page and opens two levels deep. The controls float on the map itself: the depth buttons, the search field, and a line giving the number of topics and branches and when the map was last updated at the top left; Markdown at the top right; zoom and Fit at the bottom right. While you can edit, a strip at the bottom left lists the keys. It is hidden on touch screens. Click a topic to select it.
  • Add topics. Point at a topic and click the + beside it, or select it and press Tab for a child or Shift+Enter for a sibling. A new topic is called New topic and opens ready to be named.
  • Edit a topic. Double-click it, or select it and press Enter, to edit its title and its note, the small print under it. In the title, Enter saves. In the note, Enter starts a new line, and ⌘Enter (Ctrl+Enter on Windows) or clicking away saves. Escape cancels. The centre and the main branches have a title only. Editing the centre renames the document itself.
  • Move topics. Alt+↑ and Alt+↓ move a topic among its siblings. Alt+→ makes it a child of the topic above, and Alt+← moves it back out. The whole branch travels with it.
  • Drag to reparent. Drag a topic onto another and it becomes that topic’s last child. A collapsed target opens on drop. Dropping a topic inside its own branch does nothing.
  • Tick a topic done. A topic can carry a checkbox, so a map can double as a plan. Ask your agent to add them, or add them in the Markdown panel below. Ticked topics dim.
  • Delete a topic. Select it and press Delete. A topic with sub-topics or a note asks you to confirm and says how many sub-topics go with it. The delete shows a Deleted "…" message with Undo.
  • Undo. ⌘Z (Ctrl+Z on Windows) takes back your last change to the map. It works back through the changes you made since you opened it, but not a rename of the centre.
  • Collapse and expand. A topic with children has a small round button on its right edge. Click it, or select the topic and press Space. A collapsed topic’s button shows how many topics are hidden. The depth buttons, 1, 2, 3, and All, set the whole map at once. Collapse a topic by hand and the depth shows Custom.
  • Focus on a branch. A topic with children has a focus button on its left edge. It shows that branch on its own. Full map brings the rest back.
  • Find a topic. The Find in map field dims everything that does not match, opens the branches that do, and counts the matches, such as 3 hits. It searches titles and notes.
  • Move around. Drag empty space to pan and scroll to zoom. The zoom buttons sit at the bottom right. The percentage between them resets to 100%, and Fit frames the whole map again.
From the keyboard, press Enter or an arrow key to enter the map. The arrow keys then walk it: left to the parent, right into the first child, up and down between siblings. Escape steps back out one level at a time. It closes an open edit, then clears the selection, then leaves a focused branch, and finally releases the map so Tab moves on through the page. A topic title can link to another document in your workspace, and the link is clickable on the map. A branch with nothing under it is fine, and so is a map with no branches at all. Topics then hang straight off the centre.
Panning, zooming, collapsing, focusing, searching, and changing depth only change what you are looking at. They are never saved, so opening a map and exploring it writes nothing.

Seeing what your agents see

The Markdown toggle opens a Canonical markdown panel beside the map. It shows the document exactly as it is stored, which is exactly what an agent reads. When you change the map, the lines your change touched flash for a moment. You never need the panel, but it is there because you should always be able to check what your agents are working from. Edit in the panel lets you change the text directly. While the draft is not a valid map, Apply stays disabled and the line under the text says what is wrong. When it is valid, the line reads Valid. Apply updates the map. Cancel drops the draft. A map on a locked document is read-only for everyone: you can still pan, zoom, collapse, and search, but topics cannot be changed. The details rail starts closed, and there is no width control. See Working with a formatted document.

Kanban boards

Columns of cards you drag between stages.

Document formats

All six formats, and which to pick.