若VSCode中Markdown Preview Enhanced预览异常，需依次执行：一、卸载重装插件以清除残留；二、配置MathJax本地路径确保公式渲染；三、设置Pandoc路径启用PDF导出；四、禁用其他Markdown预览插件避免冲突。
如果您在VSCode中使用Markdown Preview Enhanced插件时发现预览窗口无法正常渲染、数学公式不显示或导出功能异常，则可能是由于插件配置、依赖未安装或渲染引擎冲突所致。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、检查并重装插件
该方法通过彻底清除插件残留配置，避免旧版缓存或损坏文件干扰新版本运行。重新安装可确保获取最新兼容性修复与核心渲染模块。
1、点击VSCode左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Markdown Preview Enhanced，找到后点击右侧的卸载按钮（垃圾桶图标）。
3、重启VSCode，再次搜索该插件，点击安装并等待完成。
4、安装完毕后，右键任意 .md 文件，选择 Open Preview to the Side 验证是否生效。
二、启用本地MathJax支持
该方法绕过CDN加载限制，在无网络或防火墙拦截场景下保障LaTeX数学公式正确渲染。插件默认尝试从远程加载MathJax，但本地路径引用更稳定可靠。
1、按下 Cmd+, 打开设置界面，切换至 Extensions → Markdown Preview Enhanced。
2、找到 Mathjax Path 选项，点击编辑按钮（铅笔图标）。
3、将值修改为：https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js（推荐）或 node_modules/mathjax/es5/tex-mml-chtml.js（需提前在工作区执行 npm install mathjax）。
三、配置Pandoc路径以启用PDF导出
该方法使插件调用系统级Pandoc工具链，从而支持将Markdown准确转换为PDF格式。若未配置，导出按钮将灰显或报错“pandoc not found”。
1、在终端中执行 which pandoc，确认输出类似 /opt/homebrew/bin/pandoc 的路径。
2、进入VSCode设置，搜索 markdown-preview-enhanced.pandocPath。
3、将该设置值设为上一步获取的完整路径，例如：/opt/homebrew/bin/pandoc。
4、保存后，右键MD文件，选择 Export to PDF 测试导出流程。
四、禁用与其他预览插件的冲突
该方法防止VSCode同时激活多个Markdown预览服务导致端口占用或DOM注入竞争。插件间资源抢占会引发空白预览页或样式错乱。
1、在扩展面板中依次查找以下名称的插件：Markdown Preview, Markdown All in One, Markdown Preview GitHub Styling。
2、对除 Markdown Preview Enhanced 外的所有Markdown预览类插件，点击停用（Disable）按钮。
3、关闭所有已打开的预览标签页，再重新右键打开预览验证效果。
