📜  markdown 可折叠列表 (1)

📅  最后修改于: 2023-12-03 15:02:52.045000             🧑  作者: Mango

Markdown 可折叠列表

在编写文档时,经常会遇到需要在列表结构中折叠内容的情况。Markdown 提供了可折叠列表的功能,可以让文档更加紧凑和易读。

如何创建可折叠列表

Markdown 的可折叠列表是通过 HTML 的 <details><summary> 标签实现的。具体来说,需要按照以下格式编写 Markdown 代码:

- 可折叠列表项 1
  <details>
    <summary>折叠内容 1</summary>

    折叠的内容 1
  </details>
- 可折叠列表项 2
  <details>
    <summary>折叠内容 2</summary>

    折叠的内容 2
  </details>

其中,每个可折叠列表项以 - 开头,折叠的内容用 <details><summary> 标签包裹,折叠的内容在 <details> 标签内以普通文本的形式编写即可。

示例

以下是一个示例代码片段,用于展示 Markdown 可折叠列表的效果:

- 可折叠列表项 1
  <details>
    <summary>折叠内容 1</summary>

    折叠的内容 1
  </details>
- 可折叠列表项 2
  <details>
    <summary>折叠内容 2</summary>

    折叠的内容 2
  </details>

在 Markdown 渲染引擎中运行以上代码,可以看到如下效果:

  • 可折叠列表项 1

    折叠内容 1

    折叠的内容 1

  • 可折叠列表项 2

    折叠内容 2

    折叠的内容 2

注意事项

需要注意的是,上述代码片段中,折叠的内容前后需要有一个换行,否则渲染效果可能会发生错误。此外,Markdown 并不再官方规范中支持使用 <details><summary> 标签,因此不同的渲染引擎对此的支持程度可能会有所不同。在实践中需要谨慎使用。