Jupyter Book生成的HTML无法识别行内公式问题求助

• 按照JupyterBook官方文档说明，行内公式只需用单个$包裹即可，例如$y = wx + b$，但通过jb build ...命令生成HTML书籍时，这类行内公式未被识别，直接以带$符号的纯文本显示。
• 用双$$包裹的块级公式可正常渲染。
• 已将JupyterLab更新至4.0.3，且更新以下依赖后问题仍未解决：
  • Jupyter Book : 0.15.1
  • External ToC : 0.3.1
  • MyST-Parser : 0.18.1
  • MyST-NB : 0.17.2
  • Sphinx Book Theme : 1.0.1
  • Jupyter-Cache : 0.6.1
  • NbClient : 0.5.13
• 但通过JupyterLab导出功能生成的HTML能完美显示所有公式。

1. 开启MyST Parser的行内公式支持
   在书籍的_config.yml文件中，添加或确认以下配置，启用负责解析单个$行内公式的dollarmath扩展：

   parse:
     myst_enable_extensions:
       - amsmath
       - dollarmath
   

   部分版本的JupyterBook默认未开启该扩展，这是行内公式无法解析的常见原因。

2. 确认Sphinx的MathJax配置
   检查_config.yml中的Sphinx配置，确保MathJax扩展已加载且路径正确：

   sphinx:
     config:
       mathjax_path: "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
       extensions:
         - sphinx.ext.mathjax
   

   MathJax是公式渲染的核心依赖，配置缺失会导致公式无法正常显示。

3. 规范公式格式
   确保行内公式的$前后没有多余空格，正确格式应为$y = wx + b$，而非$ y = wx + b $（前后空格会干扰解析逻辑）。

4. 清除缓存后重新构建
   旧的构建缓存可能残留错误解析逻辑，执行以下命令清除缓存后重新构建：

   jb clean <你的书籍目录名>
   jb build <你的书籍目录名>
   

内容的提问来源于stack exchange，提问作者Thomas Gamsjäger