markdown preview图片显示红叉或空白并非插件故障，而是因浏览器安全策略拦截file://协议下的本地图片请求；需启用http_server配置，通过http://127.0.0.1:8080服务代理加载，配合纯相对路径（如./images/logo.png）方可正常显示。
为什么 MarkdownPreview 里图片显示为红叉或空白
不是插件坏了，是 Sublime 没把图片路径当“可加载资源”处理。MarkdownPreview 生成的 HTML 默认走 file:// 协议直接打开，而现代浏览器（Chrome、Edge、Safari）会拦截本地文件中的相对路径图片请求，报 CORS 或 Not allowed to load local resource 错误。
常见现象包括： 渲染后是断链图标、控制台报 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 模式设计。
- 正确示例：
、、 - 错误写法：
（绝对路径）、（协议显式）、（根路径，服务器不映射） - 图片文件必须和 .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 修改只在新启动实例中加载，旧窗口不会热更新。
