Skip to content

The map

The map draws your whole notebook as a web. Each note is a dot, with solid lines joining parents to their children and dashed lines for cross-links. It’s the quickest way to see the shape of what you’ve written, and to spot the notes that everything else hangs off.

To open it, select Map at the foot of the tree. It’s at /your-name/-/map.

  • Solid lines join a note to the notes inside it (Parent → child).
  • Dashed lines, in your theme’s accent colour, are Cross-links made with @.
  • Bigger dots have more connections (Size = connections). Notes further down the tree are drawn fainter.

The layout is the same every time you open it, so the shape you learn to recognise stays put. The dots settle into place and then stop moving.

Above the map:

  • Untick Parent → child or Cross-links to hide that kind of line.
  • Tick Colour by tag to colour each dot by its tag. See Colouring by tag.
  • Fit to view brings the whole map back into the frame.

With Colour by tag on, each note’s dot takes the colour of its tag, and a key below the map lists every tag that’s colouring a dot, with its colour. Notes without tags keep the usual colour. If none of the notes on the map has a tag, the key says None of these notes is tagged.

A dot can only be one colour, so a note with several tags is coloured by the first of them in alphabetical order. There are ten colours, and no two tags share one. With more than ten tags on the map, the ten used by the most notes get colours, and the rest stay the usual colour. The key lists the coloured tags alphabetically, then says how many are left, for example +3 more tags, left uncoloured — there are only 10 colours to tell apart. A tag tends to keep its colour from one visit to the next, and when you focus on part of the map, the key only lists the tags on screen.

To With a mouse On a touch screen
Pan Drag the background Drag with one finger
Zoom Scroll wheel Pinch
Move a note’s dot Drag it Drag it
Select a note Click it Tap it
Open a note Double-click it Select it, then Open

Selecting a note doesn’t open it, so you can pan freely without landing somewhere by accident. A card appears with its title and path, and two buttons:

  • Open goes to the note.
  • Focus here shows just that note’s neighbourhood.

A big notebook can be a lot to take in at once. Focusing shows one note and every note within two steps of it, where a step is any line on the map: a parent, a child, or a cross-link in either direction.

  • Select More, then Map from here, on any note page, or Focus here on a selected dot.
  • The heading says Around and the note’s name.
  • Select show everything to go back to the whole map.

Map always opens the whole map, on a phone too. On a small screen, pinch to zoom, use Fit to view, or open the map from a note with More › Map from here.

The map is drawn as a picture, which a screen reader can’t read. Under it, All … notes as a list opens a list of the same notes as ordinary links. Choosing one opens that note. Moving through the list with the keyboard highlights each note on the map as you go.

Anyone can open the map of a notebook they can see part of. A visitor’s map only has your public notes on it, and a line is only drawn when they can see the notes at both ends, so the shape of your private notes never shows through the gaps.