Writing and organization / SERIES 05 / SERIES 02
Topics and Reference Books
Organize articles using stable links, reading orders and nested chapters
A topic gives readers a suggested order. A reference book organizes entries into chapters. Both reuse the original content IDs.
Stable links and attachments
Use a link such as [First article](content:first-note) when the target exists. An article keeps its URL if its ID stays the same. Attachments use relative paths, so review those links after moving files.
Define a topic
knowledge/topics/first-steps.yamlyaml
id: first-stepstitle: First stepsintro: A short reading sequenceentries: [first-note]Define a book
knowledge/books/my-handbook.yamlyaml
id: my-handbooktitle: My handbooksubtitle: Notes to revisitintro: Useful explanationstheme: indexchapters: - title: Getting started children: - id: first-noteRun pnpm check after changing references.
Continue in topic order
Continue in topic order