文章内容注释

在正文中写入 [+标签]，并使用同名注释定义添加说明。读者可以点击标记查看补充内容，注释支持列表、链接与代码。

原版技术参考与完整示例（英文）

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.

1
Astro renders most of a page ahead of time and hydrates **interactive islands** [+islands] only when they need to become interactive.
2

3
[+islands]:
4
  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 [+islands] only when they need to become interactive.

An island is an interactive UI component surrounded by static HTML. This keeps the default page lightweight while preserving focused interactivity.

Rich content#

Definitions may contain paragraphs, emphasis, links, lists, and inline code [+rich-note] while the surrounding sentence continues normally.

Authoring guidance

Keep the first sentence self-contained.
Use a link when readers may need the primary source.
Prefer concise examples such as client:visible.

See the Astro islands documentation for the full model.

Multiple definitions#

Reuse a label [+review] to present a short sequence of related notes behind one marker.

Start with the decision that changes the reader’s next action.

Keep implementation evidence separate from background context.

Remove details that belong in the main article instead of the annotation.

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

Lambのblog

Basic syntax#

Rich content#

Multiple definitions#

继续阅读

换条路线

Lambのblog

Basic syntax#

Rich content#

Multiple definitions#

分享文章

沿着主题读

换条路线