226 words
1 minute
Content Annotations

Content annotations keep supporting context close to a sentence without placing it directly in the reading flow. Activate the small note marker to reveal its content.

Basic syntax#

Add a [+label] reference in ordinary prose, then define the matching note elsewhere in the same article.

Astro renders most of a page ahead of time and hydrates **interactive islands** [+islands] only when they need to become interactive.
[+islands]:
An island is an interactive UI component surrounded by static HTML. This keeps the default page lightweight while preserving focused interactivity.

Astro renders most of a page ahead of time and hydrates interactive islands only when they need to become interactive.

Rich content#

Definitions may contain paragraphs, emphasis, links, lists, and inline code while the surrounding sentence continues normally.

Multiple definitions#

Reuse a label to present a short sequence of related notes behind one marker.

Undefined references such as [+missing] remain ordinary text, so an unfinished definition never creates an empty control.

Content Annotations
https://shirone.mysqil.com/posts/content-annotations/
Author
Shirone
Published at
2026-08-27

Share Article

Generate a share poster or copy the link to share this article.

Continue reading

Related reading

Based on shared tags and categories

Take another route

A consistent pick from other articles