VSCode中Jupyter Notebook的Markdown无法渲染LaTeX公式求解决办法

问题背景 #

从Jupyter Notebook导出的Markdown代码包含LaTeX公式，在浏览器中能正常显示，但在VSCode里出现渲染报错（如图所示），问题根源在于VSCode的LaTeX渲染机制与Jupyter的语法兼容问题。

对应的Markdown代码如下：

<a name="3.5"></a>
### 3.5 正则化逻辑回归的梯度

在本节中，你将实现正则化逻辑回归的梯度计算。


正则化代价函数的梯度包含两部分。第一部分 $\frac{\partial J(\mathbf{w},b)}{\partial b}$ 是一个标量，另一部分是与参数 $\mathbf{w}$ 同维度的向量，其中第 $j^\mathrm{th}$ 元素定义如下：

$$\frac{\partial J(\mathbf{w},b)}{\partial b} = \frac{1}{m}  \sum_{i=0}^{m-1} (f_{\mathbf{w},b}(\mathbf{x}^{(i)}) - y^{(i)})  $$

$$\frac{\partial J(\mathbf{w},b)}{\partial w_j} = \left( \frac{1}{m}  \sum_{i=0}^{m-1} (f_{\mathbf{w},b}(\mathbf{x}^{(i)}) - y^{(i)}) x_j^{(i)} \right) + \frac{\lambda}{m} w_j  \quad\, \mbox{for $j=0...(n-1)$}$$

解决方法 #

1. 启用VSCode内置LaTeX渲染 #

打开VSCode设置（快捷键Ctrl+,），搜索markdown.math.enabled，确保该选项处于勾选开启状态。

2. 安装专用公式渲染扩展 #

若内置渲染无法兼容，安装以下扩展之一：

• Markdown All in One：自带完善的LaTeX公式渲染能力，安装后重启VSCode即可自动识别并渲染公式。
• LaTeX Workshop：除了支持Markdown中的公式，还能处理完整LaTeX文档，适合频繁使用公式的用户。

3. 配置扩展适配Jupyter语法 #

部分扩展需要调整设置来匹配Jupyter的公式语法：

• 对于Markdown All in One，搜索设置markdown.extension.math.enabled确保开启；若仍有问题，检查markdown.extension.math.delimiters，添加Jupyter常用的分隔符配置：

  "markdown.extension.math.delimiters": [
    {"left": "$", "right": "$", "display": false},
    {"left": "$$", "right": "$$", "display": true}
  ]
  

4. 检查公式语法细节 #

VSCode的渲染器对LaTeX语法要求更严格，比如原公式中的\mathrm{th}若出现报错，可尝试替换为\text{th}；同时确保所有括号、分隔符配对完整，避免语法错误导致渲染失败。

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