二甲基

语法格式#

在正文中使用 [+tag] 插入引用标记，并在下方或文末定义注释块：

1
Astro 采用孤岛架构 [+islands] 来保持页面的极速加载。
2

3
[+islands]:
4
  孤岛架构指由静态 HTML 所包裹的独立交互组件区域，只有交互区域才加载 JavaScript。

渲染效果：Astro 采用孤岛架构 + 来保持页面的极速加载。

标记名 islands 只是一个标识符，正文中的 [+islands] 与定义块 [+islands]: 通过它配对，两者出现的先后顺序不作要求。

一篇多处注释#

1
站点在构建期完成 SSR [+ssr]，产物是纯静态文件，因此首屏没有水合等待 [+hydration]。
2

3
[+ssr]:
4
  服务端渲染。页面 HTML 在构建阶段就已生成。
5

6
[+hydration]:
7
  水合。浏览器接管静态 HTML 并挂载交互逻辑的过程。

渲染效果：站点在构建期完成 SSR +，产物是纯静态文件，因此首屏没有水合等待 +。

与脚注的取舍#

渲染效果与交互#

• 行内标记：正文中的标记呈现为精巧的高亮徽标。
• 桌面端旁注：在大屏幕设备上，注释内容优雅地显示在右侧边栏旁注区域。
• 移动端弹出：在触屏或窄屏设备上，轻触标记即可唤出居中浮层卡片查看详细注释。
• 纯静态输出：注释内容直接由服务端输出，兼顾无障碍访问与爬虫抓取。