Rhizome
NotesArticlesTagsGraphEditor

Built with Rhizome β€” A static personal notes system

  1. Home
  2. /Notes
  3. /Embeds and Anchors

Embeds and Anchors

2026-02-14Β· 2 min readΒ· 369 words

Learn how to use Obsidian-style embeds and anchors for linking and transcluding content.

#guide#embeds#anchors#obsidian

Table of Contents

  • Heading Anchors
  • Block IDs
  • When to Use Block IDs
  • Note Embeds
  • Full Note Embed
  • Section Embeds
  • PDF Embeds
  • Embed Errors
  • Deep Linking
  • Combined Syntax

Embeds and Anchors

Rhizome supports Obsidian-compatible syntax for linking to specific sections and embedding content inline.

πŸ’‘

Try clicking the anchor links on this page to see auto-scrolling in action. Links work in both full-page view and split-view panes.

Heading Anchors

Link to a specific section within a note using the # syntax:

SyntaxResult
[[Note|#Section]]Links to a specific heading
[[Welcome to Rhizome|#Core Features]]Welcome to Rhizome
[[Knowledge Graph Basics|#Why Graphs Matter]]Knowledge Graph Basics

The anchor text is case-insensitive and automatically slugified to match heading IDs.

Block IDs

Link to a specific paragraph or content block using block IDs:

Some important content ^my-block-id

Then link to it: [[Note#^my-block-id]]

This is a paragraph with a block ID.

You can link to this block: [[Embeds and Anchors#^demo-block]] β†’ Embeds and Anchors

When to Use Block IDs

Block IDs are useful for:

  • Referencing specific tips or key points from other notes
  • Creating permalinks to important paragraphs
  • Linking to content that might move if headings change

Example: Link to the quick start guide with [[Welcome to Rhizome#^quick-start]]

Note Embeds

Embed entire notes inline using the ! prefix:

Full Note Embed

![[Note Title]]

Example:

β†— Markdown Guide#wiki-links

Wiki-Links

Wiki-links are the primary way to connect notes in Rhizome:

SyntaxResult
[[Note Title]]Links to note by title
[[Note Title|display text]]Shows "display text" but links to note
[[Note#Section]]Links to specific heading in note
[[Note#^block-id]]Links to specific block by ID
[[Note#Section|display text]]Anchor link with custom text
[[Knowledge Graph Basics]]Knowledge Graph Basics
[[Knowledge Graph Basics|learn about graphs]]learn about graphs
[[Embeds and Anchors#Heading Anchors]]Embeds and Anchors
πŸ’‘

Wiki-links are case-insensitive. [[welcome to rhizome]] and [[Welcome to Rhizome]] link to the same note.

Clicking a wiki-link opens it in a split pane, letting you view both notes side-by-side. See Split-View Navigation for more.

For advanced features like embedding notes inline (![[...]]), see Embeds and Anchors.

Section Embeds

Embed just a specific section from a note:

![[Note Title#Section Name]]

This transcludes the section including all nested subheadings. Here's a working example:

β†— Knowledge Graph Basics#why-graphs-matter

Why Graphs Matter

Emergent Structure

Traditional hierarchies force you to decide where something "belongs." Graphs let structure emerge from connections.

A note about "Decision Making" might connect to:

  • Cognitive biases
  • Team dynamics
  • Data analysis
  • Risk assessment

Each connection is a potential path to discovery.

Context Preservation

When you follow a link, you see not just the destination but how you got there. The link context (surrounding text) explains the relationship.

Serendipitous Discovery

The graph view reveals:

  • Clusters - Groups of densely connected notes
  • Bridges - Notes that connect different clusters
  • Orphans - Isolated notes that might need connections
  • Hubs - Notes with many connections (often core concepts)

PDF Embeds

Embed PDF files using the same wikilink syntax:

![[document.pdf]]
![[document.pdf#page=5]]

See PDF Viewer for full documentation on PDF embedding, page deep linking, viewer controls, and external URLs.

Embed Errors

When an embed target cannot be found, an error is displayed:

  • Not found: The note or file doesn't exist
  • Section not found: The note exists but the heading wasn't found
  • Block not found: The block ID wasn't found in the note
  • Cycle detected: Recursive embed detected (embedding a note that embeds itself)

Deep Linking

Anchors work with split-view navigation. Clicking [[Note#Section]] opens the note in a split pane and automatically scrolls to that section.

Try it: Split-View Navigation opens the split-view docs scrolled to the controls section.

Combined Syntax

You can combine all features:

SyntaxPurpose
[[Note]]Basic link
[[Note|#Section]]Link with anchor
[[Note|#^block-id]]Link to block
[[Note|#Section|alias]]Link with anchor and alias
![[Note]]Full embed
![[Note|#Section]]Section embed
![[file.pdf]]PDF embed
![[file.pdf#page=5]]PDF at specific page

Backlinks

Block IDs

  • Embeds and Anchors

    ...his block: Embeds and Anchors^demo-block β†’ Embeds and Anchors^demo-block When to Use Block IDs Block IDs are useful ...

Use Anchor Links

  • Knowledge Graph Basics

    ...Note^block-id]] for referencing key points See Embeds and AnchorsHeading Anchors for details. Some notes serve as navigational hu...

Wiki-Links

  • Markdown Guide

    ...]] | | Embeds and AnchorsHeading Anchors | Embeds and AnchorsHeading Anchors | <Callout type="tip"> Wiki-links are case-insen...

Anchor Links

  • Quick Reference

    ... !Markdown GuideWiki-Links Anchor Links !Embeds and AnchorsCombined Syntax Callout Types ![[CalloutsSupported Callout ...

Anchor Scrolling in Split-View

  • Split-View Navigation

    ...for both heading anchors and block IDs. Example: Embeds and AnchorsCombined Syntax opens the combined syntax reference. Use Case...

Feature Guides

  • Welcome to Rhizome

    ...rkdown GuideTables]] - Organize data in tables - Embeds and Anchors - Link to sections and embed content inline - [[C...