Get AI summaries of any video or article — Sign up free
Obsidian Block References — Now in the Obsidian App! thumbnail

Obsidian Block References — Now in the Obsidian App!

5 min read

Based on Linking Your Thinking with Nick Milo's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Block references let Obsidian link to specific paragraphs/quotes inside a note, not just whole pages.

Briefing

Block references in Obsidian are a new way to link not just whole notes, but specific paragraphs, quotes, or other “atomic” blocks inside a note—using a short identifier that keeps the link stable. That matters because it turns scattered snippets (research highlights, tweet quotes, key lines from a PDF) into navigable building blocks, so later notes can jump directly to the exact text that originally informed them.

The workflow starts with embedding a block reference at the cursor using Obsidian’s caret/carrot notation (the transcript references “shift six” to insert the carrot). After selecting a block from the autocomplete list, Obsidian converts the reference into a hashtag-style link with a hex identifier. In preview, the linked block renders as the referenced paragraph; when switching back to edit mode, the underlying hex code is visible at the end of the reference. The same mechanism works for non-embedded links: instead of exploding/embedding the block, the user can insert a link that still points to the chosen block and opens it when clicked.

A key nuance is that the carrot can be used to control what identifier text appears in the reference. In one example, a paragraph about the anterior cingulate cortex (from extracted PDF notes stored in Obsidian) is manually given a descriptive label—such as “cognitive robinson 2010 a”—by typing after the carrot. Later, when another note embeds or links to that block, the reference resolves to the exact paragraph, and the link can be clicked to jump straight to the source block.

The transcript also shows block references as a practical way to capture social and personal knowledge. A tweet quote is pasted into a daily note, then a block reference is inserted at the end of the quote. Later, a new note can link to that exact quote block, and Obsidian’s autocomplete helps select the right block within the note. The same idea scales across different levels: block references can target paragraph-level blocks, while a hashtag-style reference targets header-level sections, letting users link to a page, a header, or a specific block with different granularity.

Beyond linking, the feature adds search behavior. Using the reference search syntax with repeated brackets can expand from searching within a single file to searching across all blocks in the library; header search works similarly. The transcript also mentions additional updates in Obsidian 0.9.5: a faster checklist completion via Command+Enter, and a restyled community theme that reduces the need for excessive scrolling.

The closing takeaway is a balancing act. Block references are powerful enough to risk fragmenting a knowledge system into too many tiny linked pieces, but they also offer a way to keep context intact by anchoring ideas to the exact text that created them. The practical question becomes how much “Hulk mode” to use—full atomic linking or a calmer middle ground—depending on how a user wants their notes to stay coherent over time.

Cornell Notes

Block references in Obsidian let users link to specific blocks (like paragraphs or quotes) inside a note, not just entire pages. The process uses a carrot-based insertion (referenced as Shift+6) that triggers autocomplete of blocks, producing a stable hashtag link with a hex identifier. Users can optionally type descriptive labels after the carrot so the reference text is meaningful (e.g., “cognitive robinson 2010 a”), while still linking to the exact underlying paragraph. Block references can also be used at different levels: header-level links (hashtag) and page-level links, giving control over granularity. Search can expand from a single file to all blocks in the library, making block-level retrieval practical at scale.

How does a block reference differ from a normal note link in Obsidian?

A normal link points to a note (page). A block reference points to a specific block inside a note—such as a paragraph or quote. After inserting the carrot reference and choosing a block from autocomplete, Obsidian creates a hashtag-style link that includes a hex identifier. In preview, the referenced paragraph appears; clicking the link jumps directly to that exact block, and in edit mode the hex code is visible at the end of the reference.

What does the hex identifier do, and why is it useful?

The hex identifier is Obsidian’s stable pointer to the exact block being referenced. The transcript notes that this helps maintain consistency—especially for publishing—because the underlying URL-like reference remains consistent even when the visible label changes. When opening the link later, Obsidian can locate the precise block rather than just the surrounding note.

How can a user make block references more descriptive instead of purely technical?

By typing custom text after the carrot before selecting the block. In the example drawn from extracted PDF notes, the user inserts a block reference at the end of a paragraph and types a label like “cognitive robinson 2010 a” (derived from the author and year). Later, when another note embeds or links to that block, the reference text remains descriptive while still resolving to the correct paragraph.

How can block references be used for quotes or tweets?

A user pastes the quote/tweet text into a note (such as a daily note), then inserts a block reference at the end of that quote using the carrot autocomplete. Later, another note can link back to that exact quote block. The transcript emphasizes that autocomplete lists the blocks within the note, so selecting the right snippet is fast and precise.

What’s the difference between block-level and header-level references?

Block-level references target individual blocks (paragraphs/quotes). Header-level references target sections under headings. The transcript describes using the hashtag/header-level reference to link only the headers in a daily note, while block references link to the specific paragraph blocks. This gives flexibility: link to a page, a header, or a specific block depending on how precise the navigation should be.

How does global searching work with block references and headers?

The transcript notes that using the bracket-based search syntax more than once changes scope. A single bracket search limits results to the current file, while repeating it searches across all blocks in the library. The same concept applies to headers, enabling library-wide header search.

Review Questions

  1. When you insert a block reference and choose a paragraph from autocomplete, what visible element changes in the reference (and what hidden element is added in edit mode)?
  2. Give one example of how descriptive labeling after the carrot can improve later retrieval of a referenced block.
  3. How would you decide whether to use a header-level reference versus a block-level reference in a knowledge management workflow?

Key Points

  1. 1

    Block references let Obsidian link to specific paragraphs/quotes inside a note, not just whole pages.

  2. 2

    Using the carrot-based insertion (Shift+6) triggers autocomplete of blocks and creates a stable hashtag link with a hex identifier.

  3. 3

    Block references can be embedded (showing the referenced paragraph inline) or inserted as links that jump to the block.

  4. 4

    Typing custom text after the carrot allows references to be descriptive (e.g., author/year-based labels) while still pointing to the exact block.

  5. 5

    Granularity matters: hashtag/header references target sections, while block references target individual blocks.

  6. 6

    Search scope can expand from a single file to all blocks (and similarly for headers) using the bracket syntax.

  7. 7

    Obsidian 0.9.5 adds Command+Enter for checklist completion and restyles the community theme for better readability.

Highlights

Block references anchor later ideas to the exact paragraph that originally informed them, enabling precise navigation within a note.
Obsidian converts block references into hashtag links backed by a hex identifier, which supports consistent linking and publishing.
Carrot-based references can be labeled descriptively (like “cognitive robinson 2010 a”) without losing the underlying block precision.
Granularity is controllable: page links, header links, and block links each serve different navigation needs.
Global block search can span the entire library, turning atomic snippets into searchable knowledge units.

Topics

Mentioned