Obsidian Block References — Now in the Obsidian App!
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.
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?
What does the hex identifier do, and why is it useful?
How can a user make block references more descriptive instead of purely technical?
How can block references be used for quotes or tweets?
What’s the difference between block-level and header-level references?
How does global searching work with block references and headers?
Review Questions
- 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)?
- Give one example of how descriptive labeling after the carrot can improve later retrieval of a referenced block.
- How would you decide whether to use a header-level reference versus a block-level reference in a knowledge management workflow?
Key Points
- 1
Block references let Obsidian link to specific paragraphs/quotes inside a note, not just whole pages.
- 2
Using the carrot-based insertion (Shift+6) triggers autocomplete of blocks and creates a stable hashtag link with a hex identifier.
- 3
Block references can be embedded (showing the referenced paragraph inline) or inserted as links that jump to the block.
- 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
Granularity matters: hashtag/header references target sections, while block references target individual blocks.
- 6
Search scope can expand from a single file to all blocks (and similarly for headers) using the bracket syntax.
- 7
Obsidian 0.9.5 adds Command+Enter for checklist completion and restyles the community theme for better readability.