🧵 Stacked Notes
This theme borrows the reading model of [[Andy Matuschak’s notes::https://notes.andymatuschak.org/]]: following a link doesn’t leave the note you’re on. The linked note opens as a new pane to its right, so the screen shows the path you took to get here, left to right. For why that matters, see [[Why Books Don’t Work]].
Branching instead of a tree
A digital garden is usually browsed like a tree: an index, then a note, then back. Here a reading session is a flow. I think of the result as [[A Lattice, Not a Garden|a lattice]] more than a garden. If you go back to an earlier pane and follow a different link, everything to the right of it is dropped and the path branches from there.1 Try it: open [[Wiki Links]] and then [[Theme Features]] from this pane, and watch the second replace the first.
How it behaves
- Panes are 625px wide, a bit wider when a note has margin notes. When they no longer fit, older panes slide under newer ones and collapse to a spine with the note’s title written vertically. Click a spine to bring that pane back.
- The open panes are kept in the URL as
?stackedNotes=entries, so a path can be shared and the back button walks it. - In each pane, the link that opened the next pane stays highlighted, so you can see where you branched.
- Every note ends with Links to this note: the notes that link here, each with the paragraph the link appears in. See [[Getting Started]] for an example.
- On narrow screens, links navigate normally, one note per page.
Margin notes
Asides go in the right-hand margin, next to the sentence they belong to, instead of interrupting it.2 They’re ordinary Markdown footnotes, so the same file still reads fine in Obsidian or on GitHub, and on a phone they fall back to a list at the end of the note.
Writing notes for it
Notes stay plain Markdown, the same files you edit in Obsidian. Link with [[Note Title]], [[Note Title\|custom label]] (the backslash keeps Markdown from reading the pipe as a table) or [[Note Title#Heading]]. Nothing in a note needs to know about panes; see [[Markdown Guide]] for the rest of the syntax.
Links to this note
On these topics
-
🔭 Observability for Inner Space
The way these notes are laid out is part of the experiment: one thought opening the next to its right, instead of a single long essay. See Stacked Notes for how that works, and Why Books Don’t Work for why it might be a better way to thi...
From other notes
-
A Lattice, Not a Garden
The panes already run horizontally, so a reading session is one line across the lattice; see Stacked Notes. Topics are the lines in the top bar. Where they cross is the part I don’t control, and the part I’m most curious about.
-
Why Books Don't Work
This site borrows that reading model for my own notes; Stacked Notes describes how it behaves. His notes are his research environment, not a published tool, so nothing here is his code, only the idea.[^code] What I add is the picture of ...