Sub-pages and embedded notes

Nest notes inside a parent note with /page, and show a whole note or one of its sections inside another, kept up to date.

On this page
Documentation sections

Some notes belong under another one: the schedule of each day under the agenda of a trip, the chapters under a project. A sub-page puts them there. Other times, you want the content of a note to show inside another without copying it: an embedded note does that, and stays up to date when the original changes.

You wantUse
A new note that lives under this oneA sub-page, /page
A way to jump to another noteA link, [[ (see Link your notes)
The content of another note, visible hereAn embedded note, ![[

Create a sub-page

  1. In the parent note, type /page and press Enter.
  2. Filarr creates the sub-page, adds a block for it in the parent note, and opens it.
  3. Choose a template or a blank note, then type the title and the content of the sub-page.

Back in the parent note, the block shows the title and the icon of the sub-page, and follows them if you change them. Click the block to open the sub-page.

Find your way with the breadcrumb

Above the title of a sub-page, the breadcrumb shows where it sits: Notes, then the parent notes, then the sub-page. Click a parent to go back up.

A sub-page is a note like any other: it appears in the list of notes, in search, and in the graph.

If you delete a sub-page, its block in the parent says Deleted page. Click Remove link on the block to take it away.

Embed a note

  1. Type ![[ where you want the other note to appear.
  2. Type the first letters of its title, and press Enter.

You can also type [[, then press Tab to switch to Embed mode, or use the Embed note command of the / menu.

The note appears in a frame, with its title at the top.

An embedded note is live: when you change the original, the frame shows the change. To edit the text, open the original: click its title at the top of the frame. The × on the frame (Remove embed) removes the frame, not the note.

Drag the corner of the frame to change its size.

Embed part of a note

  • ![[Design principles#Where they come from]] shows only the section under that heading.
  • Copy link to block, in the menu of a block, copies a reference to that one block. Paste it in another note to show only that block there. See Blocks, layouts and callouts.

Good to know

  • If you delete the original, the frame says Source deleted.
  • A note can embed a note that embeds another one, up to five levels deep. Beyond that, the frame stops and says so.
  • Neither a sub-page block nor an embedded note counts as a link: they do not show in Backlinks or as links in the graph. To connect two notes, add a [[…]] link.
  • Embedded notes and sub-pages are not offered in the notes of a shared vault. If you copy a note with sub-pages into a shared vault, its sub-pages stay in your personal notes, and the other members see Deleted page.