如何在 GitHub 的自述文件 markdown 文件中使标题可折叠？

Question

如何在 GitHub 的自述文件 markdown 文件中使标题可折叠。我希望它的标题不是任何特定的文本，而是标题。

Answer 1

你不能。出于安全原因，GitHub 将删除任何可以实现您想要的功能的代码。

提醒一下，Markdown 只是渲染为 HTML。因此，您的问题的答案与 HTML 的答案相同。您需要一些 CSS 和/或 JavaScript 来控制类似手风琴的行为（请参阅此处的多个示例）。然而，出于安全原因，GitHub 不允许用户在其网站上使用 CSS 或 JavaScript，因此他们在将 Markdown 渲染为 HTML 后删除了所有 CSS 和 JavaScript。

GitHub 在 github/markup 中记录了他们如何处理用户提供的标记。如步骤 1 中所述，您的 Markdown 将转换为 HTML。然而，在第 2 步中：

2. HTML 已被清理，积极删除可能伤害您和您的亲属的内容，例如

   script

   标签、内联样式和

   class

   或

   id

   属性。

既然如此，就无法提供完成您想要的任务所需的必要 JavaScript 和/或 CSS。

作为替代方案，您可能需要考虑将文档托管在不提供此类限制的网站上。

Answer 2

您可以将此功能与标题一起使用：使用折叠部分组织信息 - GitHub Docs

例如

<details>
<summary>
Installation
</summary>

## Installation
</details>

变成：

打开：

Answer 3

如果您将 jekyll 与 markdown: kramdown 一起使用，您需要添加以下配置

#using kramdown html processor
markdown: kramdown
kramdown:
  **parse_block_html: true**