Markdown 折叠面板

折叠面板把相关的可选细节收纳进一个紧凑的分组。标题与正文都保留行内和块级 Markdown，而原生 disclosure 语义让每个面板无需客户端 JavaScript 即可使用。

独立面板#

默认情况下各个条目独立展开。在标题前加 :+ 可让该条目初始为展开状态；当分组使用 expand 时，加 :- 可保持其折叠。

软件包要求

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

安装依赖

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

1
pnpm.cmd install

校验命令

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

当只应保留一个打开的条目时，添加 accordion。浏览器会直接对原生 disclosure 分组，因此打开另一个条目会自动关闭上一个，无需水合。

expand 在这里的作用是什么？

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

标题可以包含 Markdown 吗？

可以。标题支持行内强调与 code，面板正文则支持完整的块级 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 列表。