Note Transclusion

April 16, 2026 · 1 min read

Contents

Full note transclusion
Section transclusion
Aliases in transclusion
How it looks
How it works
Target note requirements
See also

Transclusion lets you embed the content of one note inside another. OnyxFolio resolves ![[Note Title]] embeds server-side — the target note's body is rendered inline, wrapped in a styled container.

Full note transclusion

![[Note Title]]

Embeds the full body of the target note (frontmatter stripped, H1 stripped). The content is rendered as HTML and wrapped in a <div class="transclusion"> block with a link back to the source.

Section transclusion

![[Note Title#Heading]]

Embeds only the content under a specific heading — from that heading down to the next heading of equal or higher level.

If the heading is not found, the full note body is embedded as a fallback.

Aliases in transclusion

![[Note Title#Heading|Optional alias]]

The alias is silently ignored in transclusion (it's used in wiki-links). The transclusion title shown in the embed header is always derived from the target note and heading.

How it looks

The transcluded content renders as a distinct inset block:

Title bar — shows the note title (or "Title › Heading" for section transclusion), linked to the original note
Body — the target note's markdown rendered to HTML, including callouts, checkboxes, and highlights

How it works

Transclusion renders these sub-features inside the embedded body:

Callouts
Checkboxes
Highlights (==text==)
Standard markdown (bold, italic, tables, code)

Nested transclusion (a transcluded note that itself contains ![[...]]) is not recursively resolved — the inner embeds are left as-is.

Target note requirements

The target note does not need website: true to be transcludable — private notes can be transcluded.
The note is looked up by title, filename stem, or slug (same resolution as Wiki-Links).
If the target is not found, a <em class="transclusion-missing">Note not found: Title</em> placeholder is rendered instead.