Embeds and Anchors
Learn how to use Obsidian-style embeds and anchors for linking and transcluding content.
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:
| Syntax | Result |
|---|---|
[[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:
Wiki-Links
Wiki-links are the primary way to connect notes in Rhizome:
| Syntax | Result |
|---|---|
[[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:
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:
| Syntax | Purpose |
|---|---|
[[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 |