内容注释 - Lambent's Blog

内容注释可以将补充背景放在相关句子附近，而不直接插入正文阅读流。激活小型注释标记即可查看说明。

基本语法#

在普通正文中添加 [+label] 引用，再在同一篇文章的其他位置定义对应注释。

1
Astro 会预先渲染页面的大部分内容，只在 **交互岛屿** [+islands] 需要变为可交互状态时才对其进行 hydration。
2

3
[+islands]:
4
  交互岛屿是由静态 HTML 包围的交互式 UI 组件。这样既能让页面默认保持轻量，又能保留所需的局部交互。

Astro 会预先渲染页面的大部分内容，只在 交互岛屿 需要变为可交互状态时才对其进行 hydration。

注释定义可以包含段落、强调、链接、列表和行内代码，周围句子的阅读仍会自然延续。

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

未定义的引用（例如 [+missing]）会保留为普通文本，因此尚未完成的定义不会生成空控件。