Get AI summaries of any video or article — Sign up free
Roam Tour with Historian Mark Robertson Pt. 1: Daily Notes, Structured Roam, Course Organization thumbnail

Roam Tour with Historian Mark Robertson Pt. 1: Daily Notes, Structured Roam, Course Organization

Robert Haisfield·
5 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

Transclusion is used to reuse assignment and guide blocks so a single edit can update many course pages without copy-and-paste drift.

Briefing

A historian built a Roam Research setup that turns daily capture, teaching planning, and long-form writing into one connected workflow—using transclusion, queries, and block references to reduce clutter and prevent repeated edits across multiple course pages. The core shift is less about “backlinking” and more about reusing the same source blocks everywhere, so a single wording change can propagate without hunting through dozens of copies—an approach that matters when one confusing sentence can derail a whole class.

The workflow starts with a mobile-first “daily notes” page driven by an iOS shortcut. That daily hub pulls in structured inputs automatically: a journal area with an “evening reflection” query that surfaces the prior day’s entry, a randomly selected camera-roll memory for reflective prompts, weather attributes, a sleep log, and calendar data. It also includes a daily inbox for fleeting thoughts and an action list for tasks. Instead of trying to make every task show up in every query, tasks are managed with tags that control what appears by default—especially for subtasks. Subtasks are excluded from the main task query so the daily view stays readable; they only appear when expanded via transclusion, letting projects retain context without flooding the interface.

That design choice feeds into a broader tension: Roam’s “non-hierarchical” network of notes still needs hierarchy in real working life. The setup therefore imposes structure where it counts—particularly for teaching and curriculum. For courses, the system uses a Kanban-style project view for status (on deck, ongoing, done) and a course “modules” structure that must repeat each semester. Rather than migrating old content, the historian recreates course modules from a curated collection of reusable blocks. Those reusable blocks are maintained as templates using block references, so updates happen once and then flow outward.

Teaching organization is handled through course-specific pages that link to shared assignment directions and learning-management-system (LMS) materials. The course pages also track which foundational questions are being “remixed” depending on course length (e.g., a 15-week version versus a 7-week version). Visual cues—like colored dots or unicode icons—help distinguish references to content that lives elsewhere, while keeping the course map navigable without constantly checking the LMS.

Finally, the writing system adds lightweight self-interaction without turning prose into an outline. In an article workspace, the historian uses an inbox query for project capture and then annotates drafts inline with markers (pushpins) that function like argumentative or stylistic notes. A key benefit is rapid review of past writing introductions: clicking into an “introduction” section surfaces prior intros so the writer can compare style and context. The result is a Roam environment that treats daily life, teaching logistics, and drafting as one connected system—designed to stay fast, minimize clutter, and make updates reliable through transclusion rather than copy-and-paste repetition.

Cornell Notes

Roam Research is used as a single system for daily capture, teaching planning, and long-form writing. A mobile-first daily page pulls in journal prompts, weather, sleep, calendar items, and tasks via iOS shortcuts and Roam queries. To keep the interface usable as volume grows, tasks use tags so subtasks stay hidden in the main view and only appear when expanded, reducing clutter while preserving project context. For teaching, course modules are rebuilt each semester from reusable templates using block references, so a one-word change can propagate across many assignment directions. For writing, inline markers and an inbox query support drafting while also letting the writer review past introductions to refine style and structure.

Why does the setup treat transclusion as more than “just backlinking”?

Backlinking is treated as a foundation, but the real payoff comes from transclusion and block reuse. The historian wants assignment directions, FAQs, and how-to guides to exist once as source blocks, then be referenced across many course pages. That way, editing one block (even a single word) updates every place it’s used, avoiding repeated edits that can create inconsistent instructions and confuse students.

How does the system prevent task queries from becoming cluttered?

Tasks are tagged so subtasks can be excluded from the default task query. The daily action list shows only the level of tasks the historian wants visible at a glance. When deeper context is needed, subtasks appear through expansion (via transclusion), so projects keep their structure without overwhelming the daily view.

What role does mobile-first automation play in daily notes?

An iOS shortcut populates the daily page so the historian doesn’t have to type much on a laptop. The daily hub includes a journal with an “evening reflection” query pulling the prior day’s reflection, a random camera-roll image for memory-based prompts, weather attributes, a sleep log, and calendar data pulled from a calendar app. This keeps daily capture quick and consistent.

How is hierarchy handled in a system that’s described as non-hierarchical?

The historian argues that brains and day-to-day work still require hierarchy and guard rails. Roam’s network structure is used for connections, but structure is imposed through practical organization: Kanban-like project status, course pages with modules, and template-based course content. The goal is efficiency—preventing endless searching that happens when structure is left entirely to the network.

How are course materials kept consistent across semesters?

Instead of migrating old course content, the historian rebuilds modules each semester from a collection of reusable blocks. Block references serve as templates for repeated elements like assignment directions and critical reflection journal structures. After each class period, a reflection log generates a to-do list, and those updates can be applied to the template blocks so they propagate cleanly.

What writing workflow supports drafting without turning everything into an outline?

The historian uses inline markers (pushpins) and conventions to annotate drafts without breaking paragraph structure into separate bullet points. In an article workspace, an inbox query collects project items quickly, while clicking into sections like “introduction” surfaces past intros for style comparison. The system separates logic (what the argument is) from stylistic notes (how it’s presented), and uses collapsible sections to manage what’s visible while writing.

Review Questions

  1. How do tags and transclusion work together in this setup to balance context and readability in task lists?
  2. What mechanisms ensure that course assignment directions stay consistent when the historian updates wording or instructions?
  3. How does the writing system use inline annotations to support revision without forcing a traditional outline format?

Key Points

  1. 1

    Transclusion is used to reuse assignment and guide blocks so a single edit can update many course pages without copy-and-paste drift.

  2. 2

    A mobile-first iOS shortcut populates a daily Roam hub with journal prompts, weather, sleep, and calendar data to reduce manual input.

  3. 3

    Task clutter is controlled by tagging subtasks so they’re excluded from default queries and only revealed when expanded.

  4. 4

    Course organization relies on repeatable structure—Kanban-style project status plus course modules rebuilt from template blocks each semester.

  5. 5

    Block references function as templates for repeated teaching materials, making semester-to-semester updates efficient and consistent.

  6. 6

    Inline writing annotations (pushpins/markers) support revision and style tracking while preserving paragraph flow.

  7. 7

    The system treats hierarchy as necessary for real work, even if the note network itself is non-hierarchical.

Highlights

The biggest productivity win comes from editing one reusable block (sometimes just one word) and having that change propagate across every place it’s referenced in course materials.
Subtasks are intentionally hidden in the main daily task query to keep attention on what’s actionable, then revealed on demand for project context.
A daily page is automatically assembled via iOS shortcuts, pulling in reflections, random memories, weather attributes, sleep, and calendar items.
Course modules are rebuilt from block-reference templates each semester, avoiding migration headaches and ensuring consistent assignment directions.
Writing support includes inline markers plus a way to review past introductions to refine how topics are opened and contextualized.

Topics

  • Roam Daily Notes
  • Transclusion Templates
  • Task Query Clutter
  • Course Organization
  • Inline Writing Annotations

Mentioned