Skip to content
FUTO Notes

Linking notes with wikilinks in FUTO Notes

To link one note to another in FUTO Notes, type [[ and pick the note from the list, or type the note’s title in double square brackets: [[Grocery list]]. Clicking or tapping the link opens that note, on desktop, iOS, and Android.

Type [[. A list of your notes opens under the cursor and narrows as you type. Matching is case-insensitive and looks anywhere in the note’s name, including its folder. Up to 20 notes are shown at a time.

  • Up and Down move through the list.
  • Tab inserts the highlighted note. You can also click or tap it.
  • Escape closes the list and leaves what you typed.
  • Ctrl+Space opens the list again if you closed it.

Picking a note inserts its full path, such as [[Projects/Roadmap]], closes the brackets, and puts the cursor after the link so you can keep typing.

You can also type the whole link by hand, including the closing ]].

A link is ordinary text in the note. When the cursor is on its line, the brackets and the full target show, and you can edit them like any other text. On other lines, only the link shows.

A note’s link target is its path inside your notes folder, without .md: Projects/Roadmap for Projects/Roadmap.md. Either of these links reaches it:

  • The full path: [[Projects/Roadmap]]
  • Any trailing part of the path that only one note has: [[Roadmap]], as long as no other folder also has a note called Roadmap

The link shows the shortest part of the path that is unique in your vault. [[Projects/Roadmap]] shows as “Roadmap” until a second note named Roadmap appears, and then it shows as “Projects/Roadmap”.

Matching is exact, including case: [[roadmap]] does not reach a note titled Roadmap.

Open a linked note

  • Desktop: click a link to open the note in the current tab. Ctrl/Cmd+click, Shift+click, or middle-click opens it in a new tab behind the current one. Ctrl/Cmd+Shift+click opens it in a new tab and switches to it.
  • iOS and Android: tap a link to open the note. It works on the first tap, even when the editor isn’t focused. Back returns to the note you came from.

A link that doesn’t match a note shows dimmed, so you can tell before you click it. A link is also broken when its target matches more than one note, such as [[Roadmap]] when two folders each have a Roadmap note. Use the full path to fix that.

On desktop, clicking a broken link opens an empty note with the link’s text as its title. Nothing is created until you type something, so clicking by mistake leaves no empty file behind.

When you rename a note, move it to another folder, or rename a folder in FUTO Notes, every wikilink that pointed at it is rewritten across all your notes, including links inside the renamed note itself. The rewritten link uses the full new path: after moving Grocery list into Lists, [[Grocery list]] becomes [[Lists/Grocery list]]. The changed notes sync like any other edit.

Links are only rewritten when the rename happens in the app. If you rename or move .md files in your file manager or another app, links to them break until you fix them.

A link that was already broken or ambiguous before the rename is left alone.

Obsidian syntax that isn’t supported

FUTO Notes reads everything between [[ and ]] as the target. If you’re coming from Obsidian, see using FUTO Notes with an Obsidian vault. These forms don’t work the same way:

SyntaxIn FUTO Notes
[[Note|alias]]No alias. The whole text, Note|alias, is the target, so the link is broken, and renaming Note does not rewrite it.
[[Note#Heading]]No heading links. The whole text is the target.
![[Note]] or ![[image.png]]No embeds. Nothing is embedded. To show an image, use ![](image.png) (see images).

A wikilink inside inline code or a code block is plain text, not a link.

There is no backlinks panel. To find notes that link to a note, search for its title, which also finds notes that mention it.

Next steps