Markdown 折叠面板

折叠面板将相关的可选详情收拢在一组中。标题和正文保留 Markdown 的行内与块级格式，原生折叠语义则让每个面板无需客户端 JavaScript 也能使用。

独立面板#

默认情况下，各项独立展开。在标题前加上 :+ 可让该项初始展开；当整个组使用 expand 时，加上 :- 可让该项保持收起。

软件包要求

使用 Node.js 22 或更新版本，并在安装软件包前启用 Corepack。

安装依赖

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

1
pnpm.cmd install

校验命令

生成生产构建产物前，先检查内容处理流程。

如果只想保留一个展开的答案，请添加 accordion。浏览器会直接对原生折叠项分组，因此打开另一项时会关闭前一项，无需水合。

这里的 expand 有什么作用？

如果没有任何项带有 :+ 标记，它会在初始状态展开第一项。

标题可以包含 Markdown 吗？

可以。标题支持行内强调和 code，面板正文则支持完整的块级 Markdown。

窄屏上会怎样显示？

内容内边距会缩小，长文本会换行，嵌入代码则保留独立的横向滚动区域。

1
::: collapse accordion
2
- :+ 第一个标题
3

4
  第一个面板的内容。
5

6
- 带有 `code` 的第二个标题
7

8
  第二个面板的内容。
9
:::

容器必须且只能包含一个顶层无序列表。每一项都需要标题段落、空行和正文。无效或混合格式的输入会保留为可读的普通 Markdown 列表。