405 字
2 分钟
内容批注

内容批注把辅助性上下文放在句子附近,而不会直接放进阅读流中。激活小型注释标记即可显示其内容。

基础语法#

在普通正文中添加 [+label] 引用,然后在同一篇文章的其他位置定义与之匹配的注释。

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 会提前渲染页面的大部分内容,只在 交互式孤岛 需要变得可交互时才对它们进行水合。

丰富内容#

定义可以包含段落、强调、链接、列表和行内代码 ,而周围的句子仍正常延续。

多重定义#

重复使用同一个标签 ,可以在一个标记背后呈现一组简短的相关注释。

未定义的引用(例如 [+missing])仍会显示为普通文本,因此尚未完成的定义绝不会生成一个空控件。

内容批注
https://shirone.mysqil.com/posts/content-annotations/
作者
Shirone
发布于
2026-08-27
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取