Docusaurus v2 中Markdown可折叠表格渲染异常问题求助

问题原因 #

Docusaurus v2 基于MDX语法解析，默认会将HTML标签内部的缩进内容识别为纯文本/代码块，不会主动触发Markdown语法解析，你当前的代码存在两个问题：

• 表格内容加了4个空格的前置缩进，会被解析器识别为代码块
• HTML标签内部的Markdown内容没有通过空行明确和HTML标签区隔，导致解析器跳过Markdown渲染逻辑

解决方法 #

按照以下规则调整代码即可正常渲染：

1. 移除
   内部所有内容的前置缩进，

   和表格都顶格编写
2. 保证</summary>结束后和表格之间有至少一个空行
3. 表格内容完全顶格，不要加任何前置空格
4. 表格结束后可以加一个空行再闭合</details>标签

修正后的可运行代码 #

<details>
<summary>Données d'un `évènement`</summary>

| Nom                  | Champ          | Type            | Valeur par défaut   |
|----------------------|----------------|-----------------|---------------------|
| Identifiant          | id             | int UNSIGNED AI | -                   |
| Type                 | type_id        | int UNSIGNED    | -                   |
| Nom                  | name           | varchar 128     | NULL                |
| Date                 | e_date         | date            | -                   |
| Heure                | e_time         | time            | -                   |
| Site de plongée      | location       | varchar 128     | -                   |
| Niveau requis        | required_level | int             | NULL                |
| Participants maximum | max_people     | int             | NULL                |
| Contenu              | content        | blob            | NULL                |
| Créateur             | user_id        | int             | -                   |
| Date de création     | created_at     | datetime        | current_timestamp() |
| Date de modification | updated_at     | datetime        | NULL                |

</details>

以上代码在.md和.mdx文件中都可以正常渲染，折叠块展开后会显示标准的HTML表格。

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