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],渲染为普通文本。
Shirone 操作指南
连载中分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
换条路线
从其他文章中稳定抽取