Markdown 折叠面板 - 蓝色大肥鱼

折叠面板可以把相关的可选细节收拢成一个紧凑的分组。标题与正文依然保留行内与块级 Markdown，而原生的折叠语义让每个面板无需客户端 JavaScript 也能正常使用。

独立面板#

默认情况下各项独立展开。在标题前加 :+ 可以让该项初始展开，加 :- 则在使用 expand 的分组中让它保持关闭。

运行环境要求

请使用 Node.js 22 或更高版本，并在安装依赖前启用 Corepack。

安装依赖

在仓库根目录执行工作区的依赖安装命令。

1
pnpm.cmd install

校验命令

在构建生产产物之前，先检查内容管线。

当同一时刻只应保留一个答案展开时，加上 accordion。浏览器会直接对原生折叠元素分组，因此展开另一项时会自动收起上一项，全程无需水合。

这里的 expand 起什么作用？

当没有任何一项带 :+ 标记时，它会让第一项初始展开。

标题里可以包含 Markdown 吗？

可以。标题支持行内强调与 代码，而面板正文支持完整的块级 Markdown。

在窄屏上会发生什么？

内容内边距会变得紧凑，长文本自动换行，内嵌代码保留自己的横向滚动区域。

1
::: collapse accordion
2
- :+ First title
3

4
  First panel content.
5

6
- Second title with `code`
7

8
  Second panel content.
9
:::

该容器必须恰好包含一个顶层无序列表。每一项都需要一个标题段落、一个空行和正文内容。无效或混杂的输入会保留为一份普通的可读 Markdown 列表。