Jupyter Notebook导出md文件的LaTeX公式在GitLab无法渲染如何解决

该问题通常是GitLab的Markdown渲染器对LaTeX公式的语法要求比Jupyter更严格导致的，可按以下步骤排查解决：

• 第一步：调整块级公式的书写格式
  GitLab要求块级公式的包裹符号$$必须单独占行，不能和公式内容、其他文字放在同一行，这是最常见的触发原因。

  错误写法（GitLab无法识别，会直接展示源码）：

  $$c = \sqrt{a^2 + b^2}$$
  

  正确写法：

  $$
  c = \sqrt{a^2 + b^2}
  $$
  

• 第二步：区分行内公式和块级公式的语法
  如果你要使用行内公式，不要用$$包裹，GitLab的行内公式默认仅识别单$包裹的语法，示例：$c = \sqrt{a^2 + b^2}$，渲染后会直接嵌入到当前行的文字中。
• 第三步：检查GitLab项目的渲染配置
  进入对应GitLab项目的「设置」-「通用」-「可见性、项目功能、权限」页面，找到Markdown相关配置项，确认LaTeX公式渲染开关处于开启状态，部分私有部署的旧版本GitLab可能默认关闭该功能。
• 第四步：确认GitLab实例的渲染依赖
  如果你使用的是企业自行部署的私有GitLab实例，可联系管理员确认实例是否正常启用了MathJax或KaTeX公式渲染依赖，官方公共GitLab和标准部署版本默认自带该依赖，无需额外配置。
• 兜底替代方案
  如果上述配置都无法生效，可以将公式导出为SVG/图片格式，直接插入到Markdown文档中，即可保证在所有环境正常展示。

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