咨询：GitHub Pages中Markdown文件<details>标签嵌套列表的正确用法

GitHub Pages完全支持原生HTML的<details>和<summary>标签，你遇到的显示异常大概率是标签格式不规范或Markdown与HTML混合渲染冲突导致的，下面给你正确的使用示例和注意事项：

正确写法示例 #

纯HTML嵌套列表（最稳妥，避免渲染冲突） #

<details>
  <summary>点击展开课程笔记链接</summary>
  <ul>
    <li><a href="notes/chapter1.md">第一章 注释版笔记</a></li>
    <li><a href="notes/chapter2.md">第二章 注释版笔记</a></li>
    <li><a href="notes/chapter3.md">第三章 注释版笔记</a></li>
  </ul>
</details>

混合Markdown列表写法 #

如果偏好Markdown列表，需要保证内容与HTML标签的格式兼容：

<details>
  <summary>点击展开课程笔记链接</summary>
  - [第一章 注释版笔记](notes/chapter1.md)
  - [第二章 注释版笔记](notes/chapter2.md)
  - [第三章 注释版笔记](notes/chapter3.md)
</details>

常见问题排查 #

1. 标签闭合不完整：必须确保<details>和<summary>标签都正确闭合，遗漏闭合标签会导致GitHub渲染异常。
2. 格式嵌套混乱：HTML标签内的内容要保持合理缩进，避免Markdown语法与HTML标签交叉嵌套时出现解析错误。
3. 本地预览与GitHub渲染差异：ReText使用的Markdown解析库和GitHub Pages的GFM（GitHub Flavored Markdown）存在细微差异，本地预览正常不代表GitHub上能正常显示，以GitHub页面的实际渲染结果为准。

只要按照上述规范调整，<details>标签就能在GitHub Pages上正常实现默认隐藏、点击展开的效果。

内容的提问来源于stack exchange，提问作者pwesterbaan