Sublime Text 原生不支持 Markdown 图片自动上传，生态限制导致必须依赖外部工具（如 PicGo）或自行开发 Python 插件对接 OSS；OmniMarkupPreviewer 仅本地渲染，不处理网络上传。
Sublime Text 原生不支持 Markdown 图片自动上传，也没有像 VS Code 那样成熟的一键图床插件；你得自己搭链路，或者换工具——这不是配置问题，是生态限制。
为什么 OmniMarkupPreviewer 不能上传图片
它只做本地渲染：能显示 ，但路径必须严格匹配文件系统结构，且完全不触碰网络。它读取的是本地相对路径，不会调用任何上传逻辑，也不识别图床 URL。你改了图片路径、删了本地文件、甚至把图片拖进编辑器，它都无动于衷。
- 常见错误现象：预览里图片显示为“broken image”，但控制台没报错 → 实际是路径错或文件不存在，不是上传失败
- 使用场景仅限纯本地写作，比如写文档存档、离线笔记，不适合需要发布到博客、GitHub 或 CMS 的流程
- 它不读取剪贴板，不监听截图动作，不生成 URL，也不修改 Markdown 源码 —— 所有“上传”动作必须人工完成
手动图床链路怎么跑通（PicGo + Sublime）
这是目前最稳定、可复现的方案：截图 → PicGo 自动上传 → 复制 URL → 粘贴进 Sublime → 保存 → 刷新预览。关键不在 Sublime，而在外部工具协同是否顺畅。
- PicGo 必须开启“复制链接到剪贴板”和“插入到编辑器”（如果支持），但 Sublime 不在默认白名单里，所以实际只能靠“复制 URL”+ 手动
Ctrl+V - 粘贴时注意格式：要写成
，不能漏括号或空格；PicGo 输出的 URL 默认带换行，一粘就崩语法 - 建议在 PicGo 设置中关闭“上传后打开浏览器”，避免干扰工作流；同时启用“上传前重命名”，防止中文或空格导致 URL 404
- 如果你常用截图快捷键（如
Win+Shift+S），可配合 AutoHotkey 或 Keyboard Maestro 把“截图→上传→复制→光标跳转→粘贴”串成一键，但 Sublime 内部仍无感知
想真正在 Sublime 里闭环？得自己写 Python 插件对接 OSS
阿里云 OSS 是少数能被 Sublime 插件可靠调用的对象存储服务，因为 Sublime 自带 Python 3.8+ 运行时，且 oss2 库轻量、无依赖、兼容性好。但这条路不是“配置”，是开发。
- 你得先在 OSS 控制台创建子账号、绑定
OSSFullAccess权限、拿到AccessKeyId和AccessKeySecret - 插件核心逻辑是监听
on_post_save_async事件，判断当前文件是否为 Markdown，再正则匹配!\[.*?\]\((.*?)\)中的本地路径，最后调用bucket.put_object_from_file()上传并替换文本 - 难点不在上传本身，而在路径解析：Sublime 的
view.file_name()返回绝对路径，但 Markdown 里的./img/a.png是相对路径，需用os.path.join(os.path.dirname(view.file_name()), ...)拼出真实路径 - 别忽略权限：OSS bucket ACL 要设为
public-read，否则 URL 返回 403；上传后还得调用bucket.put_object_acl()显式设权限，否则默认私有
真正卡住大多数人的，从来不是“怎么写代码”，而是 OSS 权限配置错、密钥没生效、或正则没捕获到带空格的文件名——这些错误不会报 Python 异常，只会静默跳过上传，让你以为功能失效。
