VSCode 的 Markdown 实时预览无需 Python，因其基于 JavaScript 渲染引擎（如 markdown-it、KaTeX、mermaid.js）在 WebView 中运行；仅导出 PDF（用 pandoc）、自定义 Python 脚本等进阶操作才可能间接依赖 Python。
VSCode 本身不依赖 Python 就能做 Markdown 实时预览，装 Python 不是必须条件；但如果你需要导出 PDF、渲染 Mermaid 图表或用某些自定义脚本处理 Markdown，Python 才可能被间接用到。
为什么不需要 Python 来启用 Markdown 实时预览
VSCode 的 Markdown 预览（无论是内置还是插件）全部基于 JavaScript 渲染引擎（如 markdown-it、KaTeX、mermaid.js），运行在编辑器内置的 WebView 中，和本地 Python 环境完全无关。
- 快捷键
Ctrl+K V（Windows/Linux）或Cmd+K V（macOS）触发的是 VSCode 自身或插件提供的前端服务，不调用 Python 解释器 - 公式渲染靠
KaTeX或MathJax，图表靠mermaid.js，都是纯 JS 库 - 导出 HTML 也不需要 Python；导出 PDF 时，
Markdown Preview Enhanced默认用electron-pdf，不是python -m markdown
哪些场景下 Python 才真会被牵扯进来
只有少数进阶操作会间接依赖 Python，且通常不是“预览”本身所需，而是后续处理：
-
md2card这类工具若用 Python 写，需本地安装并配置python.path，但它不属于预览流程 - 用
pandoc导出 PDF 时，如果手动配置了markdown-preview-enhanced.exportOnSave并指定pandoc命令，而你系统里pandoc是通过pip install pandoc装的（极少见，官方推荐二进制安装），那才涉及 Python 环境 - 自定义
preprocess脚本：比如在settings.json里配了markdown-preview-enhanced.preprocess指向一个.py文件，这种属于高级定制，99% 用户不会用
真正要装的是这两个插件，不是 Python
想获得带公式、Mermaid、实时刷新的预览，只跟插件和设置有关：
立即学习“Python免费学习笔记（深入）”；
- 装
Markdown Preview Enhanced（作者shd101wyy），它开箱支持$$E = mc^2$$和```mermaid，无需 Python - 顺手装
Markdown All in One，补全目录生成、快捷键、自动补全等写作辅助功能 - 关键设置必须改：
markdown.preview.enabled设为false（禁用原生预览），markdown-preview-enhanced.liveUpdate设为true，否则编辑时不刷新 - 公式生效还要确认：
markdown-preview-enhanced.enableExtendedSyntax为true，且公式块前后有空行
容易踩的坑：误以为 Python 没装就预览不了
常见错误现象包括：
- 按
Ctrl+K V没反应 → 其实是文件语言模式没设成Markdown（右下角状态栏点开确认） - 公式显示为
$$E = mc^2$$原样文本 → 不是缺 Python，而是enableExtendedSyntax没开，或公式前后没空行 - Mermaid 图不渲染 → 不是没装
mermaid-cli（那是导出用的），而是插件没重启，或```mermaid代码块语法写错（比如漏了语言标识） - 预览窗口卡旧内容 → 关掉再用
Ctrl+K V重开，不是 Ctrl+R 刷新（那是浏览器刷新，对 WebView 无效）
复杂点在于：所有设置项分散在 UI 设置和 settings.json 里，且不同插件用不同前缀（markdown. vs markdown-preview-enhanced.），稍不注意就配串了。别碰 Python 相关路径，除非你明确知道自己在做什么。
