Get AI summaries of any video or article — Sign up free
The Ryan Holiday Notecard System (Heptabase tutorial) thumbnail

The Ryan Holiday Notecard System (Heptabase tutorial)

Greg Wheeler·
5 min read

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

TL;DR

Holiday’s system captures one resonant idea per card, using themes (life areas) and projects (current work with deadlines) as organizing anchors.

Briefing

Ryan Holiday’s 4x6 note-card system is built to turn reading into repeatable creative output: mark what resonates while reading, wait a few weeks, then convert those marginal notes into single-idea cards organized by theme and project. The payoff is practical—cards become a “now and next” knowledge base that can be reused for writing, publishing, and ongoing personal growth rather than letting highlights stay trapped in books or apps.

The system starts with a simple rule: every meaningful thought gets written down on a physical-style card, identified by a theme (often treated like a life area or responsibility) or by a project (with a timeline and where the idea might fit). Cards can include sentences in the reader’s own words, favorite phrasing, questions, and examples—plus verbatim quotes from other authors. The emphasis is on limited space: each card should hold one idea, not an entire book. That constraint is meant to force clarity and make later retrieval easier.

Holiday’s workflow adds a crucial delay. After reading and marking passages—using marginalia like folded page corners or flags—notes aren’t transferred immediately. Instead, the reader returns weeks later and moves only what still matters into the card system. The waiting period is framed as a filter: it helps separate “wheat from chaff” by letting weaker reactions fade while stronger insights remain. If an idea fits multiple categories, the system duplicates the card so it can live in more than one place.

A key twist is that the categories aren’t only professional. Life and “me” categories hold advice, self-criticism, relationship reminders, and even memorable moments—funny things kids say, mistakes, or meaningful scenes—so the knowledge system supports reflection, not just productivity.

Greg Wheeler then demonstrates how to implement the same logic inside Heptabase. The “box of cards” becomes Heptabase’s Card Library, while organization happens through whiteboards and tags. Whiteboards act like visible card tables—useful for scanning and drawing connections—while tags provide a linear, metadata-driven view. For each book, Wheeler creates a dedicated whiteboard named after the title. Each highlight or thought becomes a separate card, typically with a heading sized like a physical index card would allow, and with the card title representing the single idea.

To mimic duplication across categories, Wheeler shows how to add a card to multiple whiteboards without losing it in the original location, using Heptabase’s “add to whiteboard” behavior (requiring the card to be expanded so the command doesn’t move it). Tags are then added at the value level (e.g., “a life of learning”), letting the same card surface across different contexts.

Finally, the system is positioned as an output engine. Cards aren’t meant for hoarding; they’re meant to be pulled into writing, newsletters, or even conversations. With mobile access and map-style zooming, the card boxes can be opened on demand—turning stored reading insights into immediate talking points, drafts, and creative work.

Cornell Notes

Holiday’s note-card system converts reading into reusable knowledge by capturing one resonant idea per card, then organizing those cards by theme (life areas) and project (current work with deadlines). The process includes a deliberate delay: passages are marked during reading, and only after a few weeks are the highlights and thoughts transferred—helping filter out weaker reactions. Cards can be duplicated when an idea fits multiple categories, and the system includes personal categories like “life” and “me,” not just work. Wheeler’s Heptabase tutorial maps the “box of cards” to the Card Library, and the physical organization to whiteboards plus tags, enabling multiple views and quick retrieval for writing and conversation.

What should go on a single note card, and why does the system insist on “one idea” per card?

Each card is meant to hold a single, compact unit: a sentence in the reader’s own words, a favorite phrase, a question, or an example that could fit a theme or project. It can also include verbatim quotes from other authors. The constraint mirrors a physical index card’s limited space, preventing the card from turning into a mini-book. In Heptabase, Wheeler reflects this by using short headings (often H3) and treating the card title as the idea itself, so later retrieval stays fast and focused.

Why mark passages during reading but wait weeks before transferring them to cards?

The system marks passages while reading using marginalia (like folding the page corner or using flags), then delays the transfer. That waiting period is the filter: it gives the reader’s mind time to “settle” and reveal what still resonates. Only the insights that survive that pause get converted into cards, which reduces clutter and keeps the library aligned with what truly matters.

How does the system handle ideas that fit more than one theme or project?

When an idea belongs in multiple categories, the card is duplicated—so each category has its own copy. In Heptabase, Wheeler shows how to add a card to another whiteboard without removing it from the original, so the same idea can appear in multiple organizational contexts. He also warns that the “add to whiteboard” command requires expanding the card; otherwise the command changes to “move,” which would remove it from the first whiteboard.

What role do themes and projects play in organization?

Themes function like life areas or responsibilities (e.g., a life of learning), while projects represent current work with a timeline and a place where the idea could be used (like an introduction or a chapter section). Cards are categorized by theme and/or project, and when a project card is created, it can include where in the project the idea should go. This structure supports both ongoing personal reflection and concrete writing workflows.

How does Heptabase replicate the “box of cards” and provide multiple ways to browse them?

The Card Library acts like the big storage box of note cards. Whiteboards provide a visual, table-like layout where cards can be scanned side-by-side and connected with lines. Tags provide a different, metadata-driven view—more linear and searchable—so the same information can be revisited through different mental pathways. Wheeler recommends using both whiteboards and tags to get the benefits of visual mapping and structured retrieval.

Why include personal categories like “life” and “me” alongside work-related notes?

The system isn’t limited to professional productivity. Personal categories hold advice for oneself, criticisms and improvement reminders, and even memorable moments (funny lines from kids, mistakes, meaningful scenes). Wheeler describes using these notes like a “photo book” effect—when revisited, they instantly bring back the moment—supporting reflection and emotional recall, not just output.

Review Questions

  1. How does the delay between reading and transferring notes change what ends up in the card library?
  2. What’s the difference between using whiteboards and using tags in Heptabase for this system?
  3. When an idea fits multiple categories, what should happen to the card, and how is that implemented in Heptabase?

Key Points

  1. 1

    Holiday’s system captures one resonant idea per card, using themes (life areas) and projects (current work with deadlines) as organizing anchors.

  2. 2

    Mark passages during reading, then wait weeks before transferring notes to cards to filter out weaker takeaways.

  3. 3

    Cards can include paraphrases, questions, examples, and verbatim quotes, but each card should stay compact to preserve clarity and retrieval speed.

  4. 4

    If an idea fits multiple categories, duplicate the card so it can be reused in each relevant context.

  5. 5

    Personal categories like “life” and “me” are treated as first-class knowledge, supporting reflection and self-improvement alongside work.

  6. 6

    In Heptabase, the Card Library functions as the “box of cards,” while whiteboards and tags provide complementary browsing and organization views.

  7. 7

    To add a card to additional whiteboards without removing it, expand the card first so the command behaves as “add to whiteboard” rather than “move to whiteboard.”

Highlights

The system’s signature filter is time: mark during reading, then transfer only what still resonates after a few weeks.
Each card is designed to hold a single idea, mirroring the limits of a 4x6 index card to prevent knowledge hoarding.
Ideas that belong in multiple categories are duplicated, enabling reuse across both themes and projects.
Heptabase implementation maps the physical “card box” to Card Library, with whiteboards for visual layout and tags for searchable metadata.
The library isn’t only for work—personal categories store reminders, critiques, and memorable moments for ongoing reflection.

Topics