ContentSidenote

Sidenote

Margin notes, footnotes, or tooltips displayed alongside the main content. Useful for providing additional context without interrupting the reading flow.

Basic usage

A margin note that sits alongside the main text.

{% sidenote variant="sidenote" %}
This is a margin note that provides additional context without interrupting the main flow of the text. It can contain **rich formatting** and [links](/docs/getting-started).
{% /sidenote %}
<aside data-rune="sidenote" data-rune-fields="{&quot;variant&quot;:&quot;sidenote&quot;}">
  <div data-name="body">
    <p>
      This is a margin note that provides additional context without interrupting the main flow of the text. It can contain
      <strong marker="**">rich formatting</strong>
      and
      <a href="/docs/getting-started">links</a>
      .
    </p>
  </div>
</aside>
<aside class="rf-sidenote rf-sidenote--sidenote" data-variant="sidenote" data-elevation="flush" data-rune="sidenote" data-density="full">
  <div data-name="body" class="rf-sidenote__body" data-section="body" data-reading="fine">
    <p>
      This is a margin note that provides additional context without interrupting the main flow of the text. It can contain 
      <strong marker="**">rich formatting</strong>
       and 
      <a href="/docs/getting-started">links</a>
      .
    </p>
  </div>
</aside>

Footnote style

Use variant="footnote" for content that appears at the bottom of the section.

{% sidenote variant="footnote" %}
This appears as a footnote, typically rendered at the bottom of the content section with a separator line.
{% /sidenote %}
<aside data-rune="sidenote" data-rune-fields="{&quot;variant&quot;:&quot;footnote&quot;}">
  <div data-name="body">
    <p>This appears as a footnote, typically rendered at the bottom of the content section with a separator line.</p>
  </div>
</aside>
<aside class="rf-sidenote rf-sidenote--footnote" data-variant="footnote" data-elevation="flush" data-rune="sidenote" data-density="full">
  <div data-name="body" class="rf-sidenote__body" data-section="body" data-reading="fine">
    <p>This appears as a footnote, typically rendered at the bottom of the content section with a separator line.</p>
  </div>
</aside>

Tooltip style

Use variant="tooltip" for a subtle inline callout.

{% sidenote variant="tooltip" %}
This appears as a tooltip-style callout with a subtle border and background.
{% /sidenote %}
<aside data-rune="sidenote" data-rune-fields="{&quot;variant&quot;:&quot;tooltip&quot;}">
  <div data-name="body">
    <p>This appears as a tooltip-style callout with a subtle border and background.</p>
  </div>
</aside>
<aside class="rf-sidenote rf-sidenote--tooltip" data-variant="tooltip" data-elevation="flush" data-rune="sidenote" data-density="full">
  <div data-name="body" class="rf-sidenote__body" data-section="body" data-reading="fine">
    <p>This appears as a tooltip-style callout with a subtle border and background.</p>
  </div>
</aside>

Attributes

AttributeTypeRequiredDescription
variant"sidenote" | "footnote" | "tooltip"Display style: sidenote, footnote, or tooltip

Universal attributes

bg

The background layer (SPEC-088): image, video, gradient, flat overlay wash and legibility scrim, in a single injected layer behind the rune's content.

AttributeTypeRequiredDescription
bgstringBackground preset applied to this block
bg-fromstringGradient start colour — a semantic token name (→ var(--rf-color-*))
bg-gradient"to-t" | "to-b" | "to-l" | "to-r" | "to-tr" | "to-br" | "to-bl" | "to-tl"Gradient direction (bounded named set)
bg-gradient-type"linear" | "radial" | "conic"Gradient type
bg-tostringGradient end colour — a semantic token name
bg-viastringOptional middle gradient stop — a semantic token name
scrim"top" | "bottom" | "left" | "right" | "none"Scrim direction (heaviest edge); presence turns the scrim on, "none" opts out of the default cover scrim
scrim-blur"none" | "sm" | "md" | "lg"Frost scrim blur amount
scrim-strength"sm" | "md" | "lg"Gradient scrim strength
scrim-tone"dark" | "light"Whether the scrim darkens (for light text) or lightens (for dark text)
scrim-type"gradient" | "frost"Scrim treatment: gradient (default) or frost (backdrop blur)
dropcap

Per-instance drop-cap opt-in (SPEC-108).

AttributeTypeRequiredDescription
dropcapbooleanStyle the opening letter of a prose body as a drop cap (SPEC-108). Honoured only when the body reads as prose; ignored otherwise.
elevation

The chrome/depth ladder (SPEC-107). The skin maps each rung to a chrome bundle by attribute, so there is no BEM class.

AttributeTypeRequiredDescription
elevation"sunken" | "flush" | "flat" | "raised" | "floating" | "overlay" | "none" | "sm" | "md" | "lg"Surface depth on the SPEC-107 ladder (sunken→overlay); none/sm/md/lg are deprecated aliases
inset

Internal padding override.

AttributeTypeRequiredDescription
inset"flush" | "tight" | "default" | "loose" | "breathe"Inner padding of this block
motion

Scroll-reveal entrance (SPEC-105). The author declares the character, the theme owns the choreography, a behaviour owns the timing.

AttributeTypeRequiredDescription
reveal"none" | "fade" | "slide" | "scale" | "blur"Scroll-reveal entrance character (none|fade|slide|scale|blur); the theme owns the choreography
staggerbooleanCascade this block's items in as it reveals (no-op on single-child runes)
reading

Editorial register for body text (SPEC-108). The author picks the register; the theme owns the magnitude.

AttributeTypeRequiredDescription
reading"fine" | "ui" | "prose"Reading register for this block’s body (SPEC-108): fine | ui | prose. The theme owns the editorial treatment.
spacing

Block-level rhythm override.

AttributeTypeRequiredDescription
spacing"flush" | "tight" | "default" | "loose" | "breathe"Vertical spacing above and below this block
substrate

Generated pattern fills (SPEC-087). Markers only — the engine sets the attributes and cell/opacity custom properties, CSS draws the pattern.

AttributeTypeRequiredDescription
substrate"dots" | "grid" | "lines" | "cross" | "checker" | "none"Generated surface pattern
substrate-fill"inherit" | "inset"Surface fill the pattern sits on (full colour stays with tint)
substrate-opacity"sm" | "md" | "lg"Pattern ink strength
substrate-size"sm" | "md" | "lg"Pattern cell size
substrate-target"self" | "media"Which surface the pattern fills (overrides the rune/theme default)
tint

Per-rune colour override (SPEC-053): a named tint from the theme registry, with inline per-token overrides layered on top.

AttributeTypeRequiredDescription
tintstringColor tint preset applied to this block
tint-mode"auto" | "dark" | "light"Whether the tint adapts to auto, dark, or light mode
width

The track a block rune occupies.

AttributeTypeRequiredDescription
width"compact" | "narrow" | "content" | "wide" | "full"Maximum width constraint for this block
Not availableWhy
framethis rune declares neither a `frameTarget` nor a media section
prominencethis rune has no page-section header