Linking
Contents
Links are what turn a pile of files into a second brain. The generator scans every note for links to other notes and uses them to build backlinks and the Graph.
Writing links
- In markdown:
[Learning](./learning.md)– any relative link to a.mdfile. Links containing://are treated as external and left alone. - In org:
id:links,file:links, or bare[[page.org]]links – see Org Notes for the details.
Either way the target resolves to the note's slug, so cross-format links (org → md, md → org) work fine.
Backlinks
At the bottom of every page, below the graph, is a list of the notes that link to it. Each backlink shows the linking note's title and a short text preview on hover.
This is the Zettelkasten payoff: you never have to maintain "related pages" lists by hand. Link generously and the structure emerges.
How it's built
The generator runs a first pass over all notes before rendering anything:
- Org files are scanned for
:ID:properties, building an id → slug index. - Every note is scanned for internal links. Each one records a
backlink on the target and an edge in
graph-data.json. - Pages are then rendered with their backlinks and hrefs rewritten
to
/notes/<slug>/URLs.