You need to enable JavaScript to run this app. 如何在VSCode中禁用Markdown预览实时更新或设置仅保存时刷新?
优惠活动
大模型
产品
解决方案
定价
更多

如何在VSCode中禁用Markdown预览实时更新或设置仅保存时刷新?

VSCode Markdown预览卡顿解决方案(大量TeX公式场景)

问题场景

使用VSCode编辑含大量TeX数学公式的长Markdown文件时,侧边开启的实时预览窗口会随内容修改实时更新,导致编辑器明显卡顿,需求为禁用实时更新,或设置仅保存文件时刷新预览。


更新1:目前VSCode暂不支持「仅保存时刷新Markdown预览」的功能,安装第三方拓展也无法实现,相关功能需求已提交至官方社区等待评审。

更新2:临时最优解决方案:新建空白Markdown文件完成大部分编辑工作,再将最终内容粘贴回原主文件。

更新3:后续排查发现,卡顿的核心诱因之一是内置KaTeX数学渲染器和第三方同功能拓展同时运行,这也是部分场景下预览会连续刷新两次的原因:

  • VSCode 1.58(2021年6月发布)新增了内置KaTeX数学渲染功能,对应内置拓展为「Markdown Math」,可在拓展页搜索@builtin找到
  • 若同时使用Markdown All in One这类自带KaTex数学公式渲染能力的第三方拓展,两个渲染器并行会产生兼容性问题

解决方案

任选其一配置即可解决渲染冲突导致的卡顿问题:

  • 禁用VSCode内置数学渲染器:在配置文件中添加 "markdown.math.enabled": false
  • 禁用Markdown All in One的数学渲染功能:在配置文件中添加 "markdown.extension.math.enabled": false

内容的提问来源于stack exchange,提问作者kriem

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 03:30:01