Components
给文字留几种容器。
卡片收好一条值得继续读的线索,旁注放下补充的话,折叠留给想多看一点的人。
下面都是本站文章里可以直接使用的组件。先看效果,再复制写法。
本页目录
链接卡片
把一篇文章或一个项目放进正文,不打断阅读,也给它一个清楚的入口。
::link-card{href="/blog/xiaoji" title="小记" description="关于博客设计、个人风格与‘门’的一篇笔记。" meta="继续阅读"}
::需要链接时,填写地址、标题和一句介绍;卡片可以在正文里单独成段。
旁注
给正文加一句提示或背景信息,让读者自己决定要不要停下来读。
写作提示
补充内容放在这里,读者可以继续读正文,也能停下来看看。
::aside{type="tip" title="写作提示"}
补充内容放在这里,读者可以继续读正文,也能停下来看看。
::可选 note、tip 或 warning;它们分别适合普通补充、建议和需要留意的事项。
折叠内容
让延伸说明保持可见,但不占据整篇文章的节奏。
为什么保留外框?
外框划出示例区域,里面的卡片才是文章中可以复用的内容。
::collapse{title="为什么保留外框?"}
外框划出示例区域,里面的卡片才是文章中可以复用的内容。
::标题始终可见,点击后展开;键盘也可以操作。
这些是第一批内容组件。你可以回到 文章归档,看看它们适合出现在哪里。