Embeds

An embed pulls another note (or image, or PDF) into the current note inline. The embedded content is live — edit the source and every embed updates.

Syntax

Syntax	Result
![[Some Note]]	Inline the entire note
![[Some Note#Heading]]	Inline only the section under that heading
![[Some Note#^abc123]]	Inline a single referenced block
![[image.png]]	Inline an image
![[brief.pdf]]	Inline a PDF (first page renders, click to open full)

Why use embeds

• Single source of truth. Update the canonical note; every doc that embeds it is correct on next render.
• Reduce duplication. Lore that appears in three different design docs lives in one note — the others embed it.
• Lightweight summaries. A "quick reference" doc can be 90% embeds.

Caveats

• Embeds chain — embedding a note that itself embeds another works. Oracle limits chain depth to 5 to prevent runaway recursion.
• An embed of a section without a matching heading renders empty rather than failing.