Components

给文字留几种容器。

卡片收好一条值得继续读的线索,旁注放下补充的话,折叠留给想多看一点的人。

下面都是本站文章里可以直接使用的组件。先看效果,再复制写法。

本页目录

旁注

给正文加一句提示或背景信息,让读者自己决定要不要停下来读。

写作提示
补充内容放在这里,读者可以继续读正文,也能停下来看看。
MDC / Markdown
::aside{type="tip" title="写作提示"}
补充内容放在这里,读者可以继续读正文,也能停下来看看。
::

可选 note、tip 或 warning;它们分别适合普通补充、建议和需要留意的事项。

折叠内容

让延伸说明保持可见,但不占据整篇文章的节奏。

为什么保留外框?
外框划出示例区域,里面的卡片才是文章中可以复用的内容。
MDC / Markdown
::collapse{title="为什么保留外框?"}
外框划出示例区域,里面的卡片才是文章中可以复用的内容。
::

标题始终可见,点击后展开;键盘也可以操作。

这些是第一批内容组件。你可以回到 文章归档,看看它们适合出现在哪里。