VSCode原生Markdown预览仅支持基础文本渲染，不支持同步滚动、数学公式、图片路径报错等，技术文档或公式笔记需装插件；推荐Markdown Preview Enhanced实现同步滚动、LaTeX渲染、PDF导出等功能。
VSCode原生预览够用吗？什么时候必须装插件
VSCode 1.84+ 确实自带基础 Markdown Preview，但仅支持纯文本渲染、无同步滚动、不解析数学公式、图片路径出错不报错——它只是“能看”，不是“好用”。你写技术文档、带公式的笔记或要导出 PDF，原生预览立刻掉链子。
- 打开
.md文件后按Ctrl+Shift+V（Windows/Linux）或Cmd+Shift+V（macOS）可触发原生预览，但修改后需手动刷新 - 公式如
$E=mc^2$默认不渲染，需在settings.json中显式开启："markdown.preview.mathjax": true - 图片显示失败时，原生预览静默忽略，连控制台都不报错；而插件会明确提示“找不到
./assets/logo.png”
实时预览必须装 Markdown Preview Enhanced 吗
不是必须，但它是目前唯一把「同步滚动」「LaTeX 渲染」「HTML/PDF 导出」「自定义 CSS」全打包且稳定维护的方案。Live Preview（微软官方）轻量、快、无配置，但它不支持导出、不处理 Mermaid 图表、也不识别 %%{init}%% 这类增强语法。
-
Markdown Preview Enhanced安装后，右键菜单多出Open Preview to the Side，滚动编辑区时预览区自动跟随 - 导出 PDF 依赖
puppeteer：终端执行npm install -g puppeteer，否则点导出会卡住并报错Failed to launch chrome - 若已装
Markdown All in One，二者功能重叠（如快捷键Ctrl+K V），建议禁用它的预览功能，避免冲突
图床上传到底要不要装 Upload Image 插件
不装也能用图床，但硬编码路径或手动替换链接迟早崩溃。真正省心的是用 Upload Image + 配置图床服务（如 GitHub、SM.MS、阿里云 OSS），实现“粘贴截图 → 自动上传 → 插入正确链接”闭环。
- 截图后按
Ctrl+Alt+U（默认快捷键），插件自动读取剪贴板图片并上传，插入形如的链接 - 关键配置项是
uploadImage.uploadMethod和对应服务商的 token，漏填token会导致上传后返回 401 错误，但插件界面不提示 - 切勿把图床配置写死在项目里：用 VSCode 工作区设置（
.vscode/settings.json）而非全局设置，避免泄露个人 token
为什么图片经常不显示？三个最常被忽略的路径问题
90% 的图片失效不是插件问题，而是路径语义理解错位。VSCode 的 Markdown 预览器按「当前工作区根目录」解析相对路径，和你在终端里 cd 到哪无关。
- 假设工作区根是
/my-blog，文件在/my-blog/posts/2026/note.md，想引用/my-blog/assets/cat.jpg，必须写，而不是 -
Markdown Preview Enhanced支持markdown-preview-enhanced.imageFolderPath设置“默认图库路径”，设为assets后，会自动补成 - SVG 文件在原生预览里只显示 XML 源码，不是图——这是设计如此，不是 bug；要渲染 SVG，得用
SVG Viewer插件双击打开，或放进 HTML 用Live Server预览
图床和路径问题混在一起时，最容易反复试错。先确保本地路径能显示，再开图床；否则你根本分不清是上传失败，还是链接压根没插对位置。
