644 字
3 分钟
Markdown 内容注解

内容注解把补充背景贴近某个句子,又不直接塞进阅读流。点击那个小小的注解标记即可展开内容。定义行不会出现在正文里。

基础用法#

写法

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

渲染效果

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

富文本内容(Rich content)#

定义里可以放段落、加粗、链接、列表和行内代码,正文句子照常连贯。

写法

定义里可以包含段落、强调、链接、列表和行内代码 [+rich-note],而周围句子正常延续。
[+rich-note]:
**写作建议**
- 首句保持自洽。
- 读者可能需要原始出处时放链接。
- 优先用简洁示例,比如 `client:visible`。
完整模型见 [Astro 孤岛文档](https://docs.astro.build/en/concepts/islands/)。

渲染效果

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

同一标签多定义#

复用同一标签写多行定义,标记弹层里会按序列出所有相关注解。

写法

复用一个标签 [+review],可在一个标记背后呈现一串相关注解。
[+review]: 先写会改变读者下一步行动的那个决定。
[+review]: 把实现证据与背景上下文分开。
[+review]: 删掉本该写进正文而非注解的细节。

渲染效果

复用一个标签 ,可在一个标记背后呈现一串相关注解。

未定义的引用#

写了 [+标签] 但没给定义时,只渲染为普通文本,不会生成空气泡控件。

写法

这是一个未定义的引用 [+missing],渲染为普通文本。

渲染效果

这是一个未定义的引用 [+missing],渲染为普通文本。

第 11 篇,共 20 篇本文属于系列

分享文章

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

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取