Build a project wiki

Build a small wiki for a project: a home page with a table of contents, a sub-page per topic, live embeds of shared notes, and the graph.

On this page
Documentation sections

A project wiki puts everything about a project in one place, one click from each other. Alex runs a two-day workshop with Lumen Health in Lisbon, on 15 and 16 October. Her wiki is a home page with the essentials and a table of contents, a sub-page per day, links to the client and the trip, and her design principles embedded so they stay current.

In this tutorial you build that wiki. The steps work the same for any project: replace the names with yours.

Before you start

  • Time: about 25 minutes.
  • Some notes to link to. The tutorial uses three notes from Alex's notebook: Lumen Health, Lisbon trip plan and Design principles. To follow along with them, import the notebook as shown in Try Filarr with sample data. With your own project, use your own notes.

Step 1: Create the home page

  1. Click Notes in the sidebar, then + (New Note), and choose Start with a blank note.
  2. Type the title: "Lisbon workshop agenda".
  3. Write a first line that says what the project is: "Two days with the Lumen team, 15 and 16 October."
  4. On the next line, type /callout and press Enter, then write what nobody should forget: "Bring the printed agendas and the wireframes v2."

To give the page an icon or a cover, see Write your first note.

A wiki does not copy what lives elsewhere: it points to it.

  1. Type "Client: ", then [[ and "Lumen H". Press Enter to insert the link.
  2. Type "Travel: ", then [[ and "Lisbon tr", and press Enter.

[[ also finds files and folders. If you imported Alex's files, type [[ and "Hotel" to link the hotel booking PDF. When no note has the title you type, the last line of the list creates it. See Link your notes.

Step 3: Add the sections

Type ##, a space, then the name of a section, on its own line. Filarr turns the line into a heading. Create four: Goals, Schedule, People and Principles.

These headings organize the page, and they feed the table of contents of step 6.

Step 4: Add a sub-page per day

  1. Click under the Schedule heading, type /page and press Enter.
  2. Filarr creates the sub-page, adds a block for it in the home page, and opens it. Choose Start with a blank note.
  3. Wait for the sub-page to open, then type its title, "Day 1 schedule", and the timetable.

To go back to the home page, click its name in the breadcrumb above the title.

Add "Day 2 schedule" the same way. For a debrief page, pick the Meeting notes template instead of a blank note. See Sub-pages and embedded notes.

Step 5: Embed what must stay current

Some content belongs to another note but must show here, up to date. An embedded note does that.

  1. Under Principles, type ![[ and "Design pr", then press Enter. The note Design principles appears in a frame, in full.
  2. Under People, type ![[Lumen Health#Contacts]] in full. Only the Contacts section of the client note appears.

When a contact changes in the client note, the wiki shows the change. To edit an embedded text, click its title at the top of the frame: the original opens. The × of the frame removes the frame, not the note.

Step 6: Add a table of contents

  1. Click at the end of the first line of the home page and press Enter.
  2. Type /toc and choose Table of Contents.

The table lists the headings of the page and follows your changes. Click a line to jump to its section. See Blocks, layouts and callouts.

Step 7: See the wiki in the graph

The graph and the backlinks follow [[links]]. A sub-page block and an embedded note do not draw a line. So give each day a link back to the home page:

  1. Open Day 1 schedule. At the top, type "Part of ", then [[ and the first letters of the home page, and press Enter. Do the same in Day 2 schedule.
  2. Open the home page, then click Graph in the Show notes as bar, or press Ctrl+Shift+G.
  3. Click Graph settings and turn on Local graph. Set Jumps to 1 or 2.

The graph now shows only the home page and its neighbors: the day pages, the client, the trip. On the home page itself, the Backlinks section of the right panel lists the days. See The graph view.

Step 8: Keep the wiki at hand

  • Pin the home page: right-click it in the list of notes and choose Pin. It stays at the top of the list.
  • Put it next to the files: in the right panel, open the Folder list and choose the folder of the project, for example Lisbon workshop 2026 in Travel. The wiki then shows as a card in that folder, next to the flight and hotel files.

See Organize your notes.

Your wiki is done: one page to start from, a sub-page per topic, and nothing copied twice.

What next?