Sublime Text 4中Markdown图片预览失效怎么办？

本文共计1030个文字，预计阅读时间需要5分钟。

不是插件坏了，而是Sublime Text没有把图片路径当作可加载资源处理。MarkdownPreview生成的HTML默认走file://协议直接打开，而现代浏览器（Chrome、Edge、Safari）会截断本地文件中的相对路径请求，报错CORS或Not allowed to load local resource。

常见现象包括：![](images/logo.png) 渲染后是断链图标、控制台报 net::ERR_FILE_NOT_FOUND、预览页右键图片地址显示 file:///.../images/logo.png 但打不开。

• 必须用 HTTP 服务代理加载，不能双击 HTML 文件或直接用 file:// 打开
• 路径必须是相对于 .md 文件的**纯相对路径**，禁止以 / 开头或含 file://
• 避免中文路径、空格路径（如 C:\我的文档\readme.md），Windows 下极易失败
• 不要依赖“保存即刷新”——enable_autoreload 只对已打开的预览页生效，首次仍需手动触发

怎么配出能加载图片的预览流程

核心是让 MarkdownPreview 启动一个本地 HTTP 服务，把临时 HTML 和图片都通过 http://127.0.0.1:8080/... 提供，绕过浏览器的安全限制。

打开 Preferences → Package Settings → Markdown Preview → Settings，写入以下最小必要配置：

{ "enable_autoreload": true, "html_preview": true, "parser": "mistune", "markdown_extensions": ["tables", "fenced_code", "footnotes"], "http_server": true, "enable_math": false }

• "http_server": true 是关键开关，启用内置 Python HTTP 服务（Sublime 自带 Python ≥3.6 即可，无需额外安装）
• "parser": "mistune" 比默认 markdown 更可靠，原生支持表格、任务列表，且不依赖 Pygments
• 删掉 codehilite 扩展项——它强制要求 Pygments，而 Sublime 自带 Python 几乎都不带它，留着反而导致解析中断、图片区域空白
• 确保 "html_preview": true，否则插件可能退化为纯文本输出

图片路径怎么写才有效

路径不是“能不能找到文件”的问题，而是“浏览器是否被允许加载它”的问题。一切必须围绕 http_server 模式设计。

• 正确示例：![](images/logo.png)、![](./assets/chart.svg)、![](../common/icon.jpg)
• 错误写法：![](C:\project\images\logo.png)（绝对路径）、![](file:///C:/project/images/logo.png)（协议显式）、![](/images/logo.png)（根路径，服务器不映射）
• 图片文件必须和 .md 文件在同一个磁盘卷（Windows 下不能跨盘符），否则 HTTP 服务无法代理访问
• 如果图片在子目录，.md 文件也建议放在同级或父级目录——http_server 只暴露当前工作区根目录及子目录

验证和排查顺序不能乱

别一上来就改设置。按这个顺序快速定位卡点：

• 先确认右下角状态栏显示 Markdown，不是 Plain Text；点它 → Set Syntax → Markdown (GitHub flavored)
• 保存文件，后缀必须是 .md；未保存的 untitled 标签页不触发预览
• 按 Ctrl+Shift+P 输入 Markdown Preview: Preview in Browser，**不要点菜单或快捷键**（默认无绑定）
• 看浏览器地址栏：如果是 http://127.0.0.1:8080/... 开头，说明 http_server 生效；若是 file:///，说明配置没生效或插件没重载
• 打开浏览器开发者工具（F12），切到 Network 标签，刷新页面，看图片请求是否返回 200 —— 如果是 404，就是路径错了；如果是 blocked，说明还在走 file://

最易被忽略的是：改完配置后没重启 Sublime Text。Settings 修改只在新启动实例中加载，旧窗口不会热更新。