跳至主要内容

使用折叠部分组织信息

您可以使用<details>标签创建折叠部分,从而简化 Markdown。

创建折叠部分

您可以通过创建可折叠的部分来暂时隐藏 Markdown 中的部分内容,读者可以选择展开这些部分。例如,当您想在问题评论中包含可能与并非所有读者相关或感兴趣的技术细节时,可以将这些细节放在可折叠的部分中。

<details> 块中的任何 Markdown 都会折叠,直到读者点击展开详细信息。

<details> 块中,使用 <summary> 标签让读者知道里面有什么内容。标签显示在.

<details>

<summary>Tips for collapsed sections</summary>

### You can add a header

You can add text within a collapsed section. 

You can add an image or a code block, too.

```ruby
   puts "Hello World"
```

</details>

<summary> 标签内的 Markdown 默认情况下会被折叠

Screenshot of the Markdown above on this page as rendered on GitHub, showing a right-facing arrow and the header "Tips for collapsed sections."

读者点击后,详细信息将展开

Screenshot of the Markdown above on this page as rendered on GitHub, indicating that a collapsed section can contain headers, sentences of text, images, and code blocks.

可选地,要使该部分默认显示为打开状态,请将 open 属性添加到 <details> 标签中

<details open>

进一步阅读