如何在Markdown的details/summary折叠块中正确显示数学公式

问题情况 #

在GitHub仓库的Markdown里，把LaTeX数学表达式放进<details>折叠块时，用$$包裹的块级公式无法正常渲染，但块外的公式显示完全正常。示例代码如下：

<details> 
  <summary>a)</summary>
$$
    \omega = \sqrt{\frac{4 m g h}{M_{1} R^{2}}}
$$
<!-- 此处显示异常 -->
</details>


$$
    \omega = \sqrt{\frac{4 m g h}{M_{1} R^{2}}}
$$
<!-- 此处显示正常 -->

为啥会这样 #

GitHub的Markdown解析器碰到<details>这类HTML块时，内部的Markdown语法解析会受到限制，$$这种块级公式的语法没法被正确识别渲染。

解决办法 #

办法1：换成内联公式（单个$包裹） #

把块级公式改成用单个$包裹的内联公式，再加个<br>换行保持排版整洁：

<details> 
  <summary>a)</summary>
  <br>
  $ \omega = \sqrt{\frac{4 m g h}{M_{1} R^{2}}} $
</details>

办法2：用<div>把公式包起来 #

在<details>内部给公式套一层<div>，强制解析器识别内部的Markdown公式语法：

<details> 
  <summary>a)</summary>
  <div>
$$
    \omega = \sqrt{\frac{4 m g h}{M_{1} R^{2}}}
$$
  </div>
</details>

办法3：用HTML原生数学符号（适合简单公式） #

如果公式结构不复杂，直接用HTML的数学符号、下标写法替代LaTeX，不用依赖公式渲染：

<details> 
  <summary>a)</summary>
  ω = √(4mgh/(M₁R²))
</details>

实测效果 #

办法1和2在GitHub上都能正常渲染折叠块内的公式，优先推荐办法2，能完整保留块级公式原本的排版样式。

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