422 字
2 分钟

内容标注

内容标注将补充背景放在句子附近,但不直接插入正文。点击小型标注按钮即可查看内容。

基本语法#

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

Astro 会预先渲染页面的大部分内容,只在**交互孤岛** [+islands] 需要交互时才对其进行水合。
[+islands]:
孤岛是嵌在静态 HTML 中的交互式 UI 组件。这既让默认页面保持轻量,又保留了局部交互能力。

Astro 会预先渲染页面的大部分内容,只在交互孤岛 需要交互时才对其进行水合。

丰富内容#

标注定义可以包含段落、强调、链接、列表和行内代码 ,而所在句子仍能自然连贯地阅读。

多个定义#

重复使用同一标签 ,即可通过一个标记展示一组简短的相关说明。

[+missing] 这类未定义的引用会保留为普通文本,因此尚未完成的定义不会生成空控件。

内容标注
https://blog.codingshen.top/posts/content-annotations/
作者
AlexShen
发布于
2026-08-27
许可协议
CC BY-NC-SA 4.0

分享文章

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

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...