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。

安装依赖

在仓库根目录运行工作区包命令。

Terminal window
pnpm.cmd install
校验命令

构建生产产物前检查内容流水线。

  • pnpm.cmd check:manifest
  • npx.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 列表。

第 4 篇,共 20 篇本文属于系列

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取