Skip to content

Links between entries

Entries point at each other in four ways. None of them moves an entry out of its collection.

The four ways

Link Means Example Shows on
Parent “This sits inside that.” One at most. “Bench press 3×8” sits inside “Push day” the child’s breadcrumb; the parent’s Children list
Children A property that lists the entries inside this one, with their own columns. Push day → Sets: Bench press, Dips the parent
Relation “This is linked to that,” between collections, with no ownership. The book “Dune” → Author: Frank Herbert both entries
Mention An @-name inside your writing. Diary, 19 Oct: “Finished @Dune today” the writing, and “Mentioned in” on Dune
Push day holds its sets as children. Dune has a Relation to its author, shown on both sides. A diary day mentions Dune, and Dune shows Mentioned in.Push dayWorkoutsBench press 3×8Dips 3×10Sets: Parent = Push dayDuneBooksFrank HerbertAuthorsRelationDiary, 19 Oct“Finished @Dune today”mention → “Mentioned in”
A Parent is ownership. A Relation is a two-way link. A mention is a link inside writing.

Parent and Children

A Parent puts an entry inside another one. The sets of a workout, the ingredients of a recipe and the notes inside a note all use it. See Notes and the tree.

A parent lists its children only through a Children property on its collection. The property says which collection the children come from and which columns they show. Each set still shows in the Sets collection too.

Relations are two-sided

A Relation is one link, shown on both entries. Dune shows Author: Frank Herbert, and Frank Herbert shows Books: Dune, Children of Dune. Change either side and both change.

  • A Relation can hold one entry or many. A book can have two authors.
  • Deleting an author never deletes the book.
  • The second side is on by default. You can hide it on one side. Example: Flour in Foods is used by thousands of meals, so you hide that long list on Flour.

Mentions

Type @ in any Block page to mention an entry. The mentioned entry shows “Mentioned in: Diary, 19 Oct”. Nothing moves.

  • “Mentioned in” shows at once, as soon as the page saves your mention. Remove the mention and it goes.
  • A page that mentions itself, and a page in the Trash, are not listed.

When a thing seems to belong in two places

Use a Relation plus a child. “Flour” as a food is one entry in Foods that many recipes point to. “Flour 200 g” is a line inside one recipe: its Parent is Pancakes, and it has a Relation to Foods / Flour.