Skip to content

Links, tags and icons

The tree says where a note lives. Links and tags say how it connects to everything else.

In the editor, type @ at the start of a line or after a space. A menu opens listing your notes, each with its path so you can tell apart two notes with the same title. Keep typing to narrow it down, use ↑ and ↓ to choose, and press Enter (or tap one).

The note’s title goes into your text as a link. You can edit the link text afterwards; what it points at stays the same.

Linking to a note that doesn’t exist yet

Section titled “Linking to a note that doesn’t exist yet”

If you have no notes yet, the menu says No notes yet. Type a name and this will offer to make one. Unless what you’ve typed is exactly the title of a note you have, the last row of the menu is Create “…”, with A new note at the top level. Choose it to make a new, empty note with that title and link to it straight away. The status says Created “…” at the top level, and linked it.

The new note always goes at the top level of your tree, whichever note you’re writing in, and gets your default visibility. Move it somewhere else later if you like; see Renaming, moving and changing the address. If you already have a note at that address, the new one’s address gets a number on the end.

You can only link to your own notes this way. To link to anything else, use Link on the toolbar; see The toolbar.

  • If the reader can see the note being linked to, the link works.
  • If they can’t (it’s private, and they’re a visitor), the link is shown as plain text. They don’t learn the note exists or what it’s called.
  • If the note has been deleted, the link shows as broken, with the tooltip This note no longer exists, so you can see there’s something to fix.

At the foot of a note, Linked from lists every note that links to it, with each one’s path. A visitor only sees the ones they’re allowed to read.

The Needs a tidy panel on your home base keeps track of links for you:

  • Broken: links pointing at a note you’ve deleted. Open the note that holds the link and remove or change it.
  • Orphan: top-level notes that nothing links to, which are easy to forget.

Tags are labels that cut across the tree. A note about #wip can live anywhere. They belong to you: your #reference and somebody else’s #reference are unrelated.

On a note page, type in the + tag box under the title and select Add. As you type, your existing tags are suggested. The message is Tag added.

In the editor, type # and a menu opens with your existing tags. Choose one, or keep typing a new name and choose it (it’s marked Create this tag). The #word you typed is taken out of the text again: a tag is attached to the note, not written into it. The status says Tagged #….

To remove a tag, select the × on its chip, on the note page or in the editor.

Tag names can be up to 40 characters. Tags that differ only in capitals or punctuation are the same tag, so WIP, wip and Wip all go to one place.

Select a tag anywhere to see every note carrying it. All tags on your home base lists them all, with counts, at /your-name/-/tags.

On a tag’s page you can rename it under Rename this tag, then select Rename. The new name applies everywhere at once. Renaming a tag to one you already have merges the two (Merged into the tag that already had that name.).

Visitors can use tag pages too, but they only see your public notes, and the counts only include notes they can read. A tag on nothing but private notes doesn’t appear for them at all.

A note can have an emoji or a vector icon. It shows in the tree, beside the title, and in the lists of notes on your home base, tag pages, search results and the map’s list.

  1. Open the note, select More, then Settings.
  2. Under Icon, select Choose an icon….
  3. Pick from the Emoji tab or the Icons tab. The picker opens on Emoji unless you’ve turned on Open the icon picker on Icons in your settings. Each has a search box, and your Recently used icons come first. On the Emoji tab you can choose a Skin tone for the emoji that have them.

You can also choose one while making the note, with the button beside Title on the New note form. An icon you pick there wins over a template’s.

In a note’s settings, the icon is saved as soon as you pick it (Icon set.). To take it off, select Remove in the picker, or Remove under Icon.

The two kinds behave differently:

  • Emoji keep their own colours and are drawn by your device, so a note looks slightly different on Android, iOS and Windows.
  • Icons take your theme’s colour, and change with it when you switch theme.

Without JavaScript, the Icon box (in a note’s settings and on the New note form) accepts a value typed by hand, such as emoji:1f9f5 or icon:scissors.