Skip to content

List Notes

List Notes allow you to leverage your existing bullet list structure. You can turn a note into a List Note by adding the following to your frontmatter:

---
BC-list-note-field: "<field>"
---

Where <field> is one of your edge fields. For example:

---
BC-list-note-field: "down"
---
- [[A]]
- [[B]]
- [[C]]
- [[D]]

In this example, A goes down to B and D, and Bgoes down to C:

flowchart TB
	1(List Note) -- down --> 2(A) -- down --> 3(B) -- down --> 4(C)
	2 -- down --> 5(D)

By default, each item in the list will use the BC-list-note-field value to add edges. But you can override this on a per-item basis by adding the field before the link.

---
BC-list-note-field: "down"
---
- [[A]]
- child [[B]]

Would give:

flowchart LR
	1(List Note) -- down --> 2(A) -- child --> 3(B)

By default, the list note itself links to the top-level list items. You can exclude this behaviour by adding the BC-list-note-exclude-index field to the frontmatter of the list note.

---
BC-list-note-field: "down"
BC-list-note-exclude-index: true
---
flowchart TB
	2(A) -- down --> 3(B) -- down --> 4(C)
	2 -- down --> 5(D)

Normally, only the parent/child relationships are added. But you can also add edges based on the neighbours of each list item. This is useful for adding sibling/next/prev relationships.

---
BC-list-note-neighbour-field: "<field>"
---

Where <field> is one of your edge fields. For example, point down to all child items, and point next to each neighbouring item

---
BC-list-note-field: "down"
BC-list-note-neighbour-field: "next"
---
- [[A]]
- [[B]]
- [[C]]
- [[D]]
flowchart TB
	1(List Note) -- down --> 2(A) -- down --> 3(B) -- down --> 4(C)
	2 -- down --> 5(D)
	3 -- next --> 5

[!NOTE] The layout of the graph kind of obscures it, but B and D are on the same level here

  • Default Neighbour Field: Choose a default field to use for the neighbour relationships. This is useful if you have a lot of list notes, and don’t want to add the BC-list-note-neighbour-field to each one.