582 字
3 分钟
Markdown 折叠面板
折叠面板把相关的可选细节收进一个紧凑分组。标题与正文保留行内和块级 Markdown,原生 disclosure 语义让每个面板无需客户端 JavaScript 即可使用。
容器内只能有一个顶层无序列表:每一项 = 一个标题段落 + 一个空行 + 正文内容。标题前缀 :+ 默认展开、:- 默认折叠。
独立面板(默认)
各项独立开合,互不影响。
写法
::: collapse- **环境要求**
使用 Node.js 26.13.0 或更高版本,安装包之前先启用 Corepack。
- :+ 安装依赖
在仓库根目录运行工作区包命令。
```powershell pnpm.cmd install ```
- 校验命令
构建生产产物前检查内容流水线。
- `pnpm.cmd check:manifest` - `npx.cmd astro check`:::渲染效果
环境要求
使用 Node.js 26.13.0 或更高版本,安装包之前先启用 Corepack。
安装依赖
在仓库根目录运行工作区包命令。
pnpm.cmd install校验命令
构建生产产物前检查内容流水线。
pnpm.cmd check:manifestnpx.cmd astro check
手风琴模式(accordion)
加 accordion 后同一时间只展开一项,打开另一项自动收起上一项。expand 让首项默认展开(无 :+ 标记时)。
写法
::: collapse accordion expand- 这里的 `expand` 起什么作用?
当没有任何 `:+` 标记时,让第一项初始展开。
- 标题能包含 Markdown 吗?
可以。标题支持行内**强调**和 `code`,面板正文支持完整块级 Markdown。
- 窄屏下会怎样?
内容内边距变紧凑,长文本换行,嵌入代码保留独立的横向滚动区。:::渲染效果
这里的 expand 起什么作用?
当没有任何 :+ 标记时,让第一项初始展开。
标题能包含 Markdown 吗?
可以。标题支持行内强调和 code,面板正文支持完整块级 Markdown。
窄屏下会怎样?
内容内边距变紧凑,长文本换行,嵌入代码保留独立的横向滚动区。
参数与标记速查
| 写法 | 作用 |
|---|---|
accordion | 手风琴模式,一次只展开一项 |
expand | 无 :+ 项时默认展开首项 |
项前 :+ | 该项默认展开 |
项前 :- | 该项默认折叠(容器用 expand 时覆盖) |
也支持花括号写法 :::collapse{accordion=true expand=true},与空格写法等价。非法或混合格式的输入会保留为普通可读的 Markdown 列表。
Shirone 操作指南
连载中分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
换条路线
从其他文章中稳定抽取