Get AI summaries of any video or article — Sign up free
Implementing a Digital Zettelkasten using Block References in Roam Research with Beau Haan thumbnail

Implementing a Digital Zettelkasten using Block References in Roam Research with Beau Haan

Robert Haisfield·
6 min read

Based on Robert Haisfield's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Treat fleeting notes as fast, unstable “gas” and reserve the real conversation partner for evidence-backed permanent notes (“solid”).

Briefing

A practical Zettelkasten workflow in Roam Research hinges on treating notes as a time-slowed pipeline—so the “conversation” happens at the crystallized, evidence-backed permanent-note stage, not in the raw flurry of ideas. The approach reframes the classic fleeting → literature → permanent progression using physics: fast-moving “gas” thoughts become “liquid” once they’re captured and contained by reference material, then “solid” when they’re crystallized into clear claims supported by evidence. That shift matters because it prevents a common failure mode: collecting thousands of fragments without producing usable, arguable ideas.

The system’s core distinction is between what’s worth conversing with and what’s worth storing. Fleeting notes are treated as fast resonances—useful for capturing momentum, but not for building trust. Literature notes represent deeper understanding of an author, but they still aren’t the final conversation partner. Reference notes act as the container for evidence: links plus metadata (author, recommendations, and other child-block details) that let the user retrieve sources later. By the time a permanent note is created, the goal is a declarative “claim” written in the user’s own words—an ironman-like conversation partner that can be argued with, because it has been abstracted multiple times and grounded in evidence.

In Roam, the workflow is implemented through block-level structure and collapsible “thumbnails.” The permanent-note pipeline is built as nested parent blocks for fleeting notes, literature notes, and reference notes, each with a compact summary at the parent level so the user can hide complexity with one click. The granularity lives in blocks (not pages), enabling rapid navigation and frictionless retrieval: expand only what’s needed, when it’s needed. The process is intentionally time-consuming—about 15 to 45 minutes to move from fleeting notes to a permanent node—because the real knowledge work is the abstraction and selection, not the initial capture.

A second key mechanism is “indexing” within the Zettelkasten. Instead of using hashtags primarily for categorization or search, the system treats the placement of a permanent note as irrelevant to retrieval; what matters is where the conversation continues. Hashtags function as low-resolution thumbnails of what’s inside a permanent node, and an index (keyword-like) sits in front of each permanent note to help the user “see past” cards that can’t be physically viewed at once—mirroring Luhmann’s index-card approach. This changes clustering: top-level conversation threads cluster by theme, while inline references create additional clusters that emerge from the network of related claims.

Block references then power “exploratory search” and output. Inline block references act like progressive disclosure: high-level anchors let the user follow scent-like leads into deeper context, then pull relevant fleeting, literature, and reference material into outlines or drafts. One click can reveal the full chain of how a crystallized thought was formed, including the time and place context of creation. The broader principle is not just technical implementation but a behavioral goal: set a target for the kind of dialogue partner desired, then structure consumption so information is digested, slowed down, and converted into clear claims that don’t become a graveyard of unreadable fragments.

Cornell Notes

The workflow treats Zettelkasten building as a pipeline that slows ideas down until they become evidence-backed “solid” claims. Fleeting notes capture fast resonances, literature notes deepen understanding, and reference notes contain the evidence; the conversation partner is the permanent note, written as a clear declarative statement in the user’s own words. In Roam, the system relies on block-level nesting and collapsible parent-block thumbnails so complexity can be hidden while still retrievable with one click. Indexing and inline block references support exploratory search: high-level anchors reveal deeper context progressively, enabling drafting and outlining directly from the network of related claims. The payoff is usable knowledge—original ideas that can be argued with—rather than a graveyard of fragments.

Why treat fleeting, literature, and permanent notes as different “states” of thought instead of just three stages of writing?

The physics analogy is used to separate what’s worth trusting and manipulating. Fleeting notes are “gas”: fast-moving thoughts captured while reading—useful for momentum but too unstable to serve as a conversation partner. Literature notes become “liquid” once the user slows down and abstracts what an author is saying, but they still lack the final crystallization. Reference notes act as the “container” for the liquid by holding the evidence (links and metadata). Permanent notes are “solid”: the crystallized claim that can be argued with because it’s been abstracted multiple times and backed by evidence.

What role do reference notes play if literature notes already summarize an author?

Reference notes are the evidence container. Literature notes are the user’s litmus-test understanding of what the author means—often drill-down paragraphs rather than one sentence. Reference notes store what can be retrieved later: the source link (added via Roam’s command palette search) plus child-block metadata like author and “recommended by” details. That separation lets the permanent note be written as a clear claim while still allowing one-click access back to the underlying sources.

How does the Roam block structure prevent the system from becoming overwhelming?

The approach uses collapsible parent blocks with low-resolution thumbnails. Fleeting, literature, and reference content sit under parent blocks that can be expanded or collapsed with one click, so the user can skim summaries at the block level without reading a wall of text. Granularity is block-based rather than page-based, and CSS “sprinkles” are used to keep the interface simple (vanilla Roam with light styling) while still making key blocks feel like navigable units.

What’s the purpose of hashtags and indexing in this Zettelkasten setup?

Hashtags aren’t treated mainly as categorization or retrieval tags. Instead, they’re positioned as low-resolution thumbnails of what’s inside a permanent note—helping the user see what a claim contains before expanding it. An index sits in front of each permanent note, mirroring Luhmann’s keyword index idea: it helps the user “see past” cards that can’t be physically viewed, and it shifts clustering granularity to the permanent-node level.

How do inline block references change knowledge work from collecting to producing?

Inline block references enable exploratory search and progressive disclosure. High-level anchors (like a permanent note title or index keyword) let the user follow “scent” into deeper context. When expanded, the user can pull in the relevant chain: the permanent note plus its reference note, literature notes, and fleeting notes that sparked the idea. This makes drafting and outlining possible directly from the network, because the system reveals the evidence and the abstraction trail behind each claim.

What’s the behavioral principle behind the workflow—beyond Roam mechanics?

The system emphasizes having a target and a reason. It warns against endless consumption and endless fragment collection that leads to a graveyard. The goal is to digest information by slowing it down, abstracting it, and converting it into clear declarative claims that function as conversation partners. Time investment (roughly 15–45 minutes to move from fleeting to permanent) is treated as part of the knowledge work: selecting, abstracting, and crystallizing what matters.

Review Questions

  1. In the gas/liquid/solid analogy, what exactly corresponds to the “container,” and how does that mapping affect what you trust at each stage?
  2. How does collapsible block-level “thumbnails” change the way you navigate and decide what to expand while building permanent notes?
  3. When hashtags are treated as thumbnails rather than retrieval tags, what mechanism replaces categorization for finding related ideas?

Key Points

  1. 1

    Treat fleeting notes as fast, unstable “gas” and reserve the real conversation partner for evidence-backed permanent notes (“solid”).

  2. 2

    Use reference notes as the evidence container (links plus metadata), while literature notes serve as the user’s litmus-test understanding of the author.

  3. 3

    Build Roam Zettelkasten structure at the block level with collapsible parent-block thumbnails to hide complexity without losing access.

  4. 4

    Indexing and hashtag placement function as low-resolution previews of permanent-note content, not primarily as categorization or search tags.

  5. 5

    Use inline block references for exploratory search: follow high-level anchors into deeper context with one click and progressively reveal the abstraction trail.

  6. 6

    Write permanent notes as clear declarative claims in the user’s own words so they can be argued with and reused in drafting.

  7. 7

    Accept that the workflow requires time because abstraction and selection—not raw capture—are the knowledge-work steps that prevent a “graveyard” of notes.

Highlights

Fleeting notes are “fast-moving thoughts,” while permanent notes are the crystallized, evidence-backed claims meant to drive the actual conversation.
Reference notes act as the container for evidence, letting literature notes and fleeting resonances feed into a trustworthy permanent node.
Hashtags and indexes are used as low-resolution thumbnails of permanent-note content, shifting clustering toward the permanent-node level.
Inline block references enable exploratory search and drafting by progressively revealing the full chain from claim back to sources and abstractions.
The workflow’s success depends on spending 15–45 minutes turning resonances into crystallized statements, not just collecting fragments.

Mentioned