NotePic：Markdown / Obsidian 图片一键上传阿里云 OSS

大家好，最近做了一个小工具，叫 NotePic。

它解决的问题很小：把 Markdown / Obsidian 文章里的本地图片，一键上传到阿里云 OSS，然后把原来的图片引用替换成线上链接。

我做它主要是因为自己写文章时经常被图片收尾打断。

在 Obsidian 里写东西很舒服，截图直接粘进去，图片能预览，文章也能正常读。但等我准备发到公众号、知乎、掘金、个人博客，问题就来了：

![[Pasted image 20260603102000.png]]
![](./assets/demo.png)
<img src="./images/screenshot.png" />

这些图片在本地都没问题，发出去就不一定了。

公众号不认识我的 Vault，知乎不会读取本地附件，博客构建也可能因为相对路径和附件目录出问题。最后又变成手动找图、压缩、上传、替换链接、检查预览。

一次还行，多发几篇文章就很烦。

所以我把这个动作做成了一个小工具：

![[demo.png]]

处理后变成：

![](https://your-cdn.example.com/markdown/demo.png)

然后这篇 Markdown 再复制到其他地方，图片至少已经是稳定的云端链接了。

现在支持什么

NotePic 目前主要做这几件事：

• 识别 Markdown / MDX / HTML 里的本地图片
• 支持 Obsidian 的 ![[image.png]] 写法
• 上传图片到阿里云 OSS
• 自动替换正文里的图片链接
• 上传前压缩图片
• 用图片内容哈希减少重复上传
• 已经是远程链接的图片会跳过

现在有两种用法：

• Obsidian 插件：写完文章后点一下，处理当前文档图片
• CLI：适合博客仓库、工程文档、批量处理或 CI 场景

我最近主要在 Obsidian 里写文章，所以插件形态用得更多。以前在工程项目里写 Markdown / MDX 时，CLI 更顺手。

一张 GIF

这里发布前放 GIF：

Obsidian 本地图片
-> 点击 NotePic
-> 图片上传到 OSS
-> Markdown 链接自动替换
-> 复制到其他平台发布

发布前检查 GIF 是否能直接看清这三件事：

1. 处理前确实是本地图片
2. 点击后有上传和替换动作
3. 处理后正文里变成 https://... 图片链接

当前边界

先说清楚，NotePic 不是想替代 PicGo、uPic 这类成熟工具。

它现在更像一个针对 Markdown / Obsidian 发布收尾的轻量工具。我的目标不是做一个大而全的图床客户端，而是把“文章写完以后处理图片”这一步压缩掉。

目前边界也很明确：

• 当前优先支持阿里云 OSS
• 更偏 Markdown / Obsidian / 博客写作场景
• 不是一个通用相册管理工具
• 不是公共图床服务，图片还是放在你自己的 OSS 里
• AccessKey 需要自己配置，建议用单独的 RAM 子账号

之所以先做阿里云 OSS，是因为我自己现在就在用它。先把自己每天真的会用的流程跑顺，再看有没有必要扩展腾讯云 COS、S3、七牛云、又拍云之类的存储。

适合谁

我觉得它比较适合这些人：

• 用 Obsidian 写文章，但经常要发到多个平台
• 写 Markdown / MDX 博客，图片先放本地，发布前再统一处理
• 有自己的阿里云 OSS，不想依赖公共图床
• 整理旧文章或知识库时，想把本地图片转成稳定外链
• 不想每次发布都手动上传图片、替换图片链接

不适合这些人：

• 只在 Obsidian 本地看笔记，从不发布
• 已经有一套成熟图床工具，而且用得很顺
• 不想自己配置 OSS、AccessKey、Bucket
• 需要复杂图片管理、相册、团队协作

想收集的反馈

项目页在这里：

https://luhuidev.com/NotePic-OSS/

如果你刚好也有这个痛点，欢迎试用、star 或提 Issue。