内容边注 - Shirone

内容边注允许将辅助背景信息紧邻特定句子放置，而不会强行插入到正文阅读主线中。点击或激活小注记标记即可查看其详细内容。

基本语法#

在正文中添加 [+label] 引用标记，然后在同一篇文章的其他位置定义对应的边注内容。

1
Astro 会预先渲染大部分页面内容，仅在需要时才水合 **交互式孤岛** [+islands]。
2

3
[+islands]:
4
  孤岛是一种被静态 HTML 包裹的独立可交互 UI 组件。这样既保持了默认页面的轻量高效，又保留了局部的动态交互能力。

Astro 会预先渲染大部分页面内容，仅在需要时才水合 交互式孤岛 。

边注定义中支持包含多段落、加粗强调、链接、列表以及行内代码，而上下文段落依然可以正常连贯阅读。

重复使用同一个标签，可以在同一个标记下展示一组简短有序的相关批注。

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