这个系列用于预览 SoraPaper 当前支持的 Markdown 扩展语法。本篇集中展示适合组织文章内容和交互信息的块级组件。
引用块
标准 Markdown 引用使用 > 开头,适合展示摘录、观点或来源说明。
视觉层应该被感受到,但不应该比文字本身更响。
引用块也支持多段内容和列表:
第一段用于放置主要观点。
- 保持内容清晰。
- 让视觉服务于阅读。
提示块
提示块统一使用 ::: 语法。当前支持 note、info、tips、warning、success 和 error。
Note
Info
Tips
Warning
Success
Error
自定义标题
在类型后追加方括号,可以覆盖默认标题。
块内 Markdown
提示块内部仍然可以写常见 Markdown 内容,例如列表、链接、行内代码和代码块。
折叠块
折叠块适合放补充说明、较长的解释或默认不需要展开的内容。
展开查看更多
这里是折叠块内容。它可以包含普通段落、列表和代码块。
- 适合放可选信息。
- 使用浏览器原生
details/summary语义。 - 不需要额外客户端 JavaScript。
默认展开示例
这个折叠块默认展开,可以用于需要突出但又希望保持结构一致的补充内容。
标签页
标签页使用 ::::tabs 包裹多个 :::tab[标题],适合展示同一内容的不同版本。
标签页由一个 ::::tabs 容器和多个 :::tab[标题] 子块组成。实际使用时,每个 tab 都需要独立闭合。
标签页默认选中第一项。切换标签不需要客户端 JavaScript,内容会保持在文章流中。
每个 tab 内部仍然可以书写普通 Markdown,例如 加粗文字、列表和代码块。
加密块写法
加密块使用 :::encrypted 和 ::: 包围内容。password 是页面解锁时要输入的密码,构建后不会写入最终 HTML。
:::encrypted[私密笔记]{password="密码提示"}
这段内容会在构建后以密文形式进入页面,并在浏览器中输入密码后解锁。
```ts
const secret = "encrypted at build time";
```
:::加密内容Encrypted content