Markdown 图片上传器
这是一个 VSCode 扩展,可以自动将 Markdown 文件中的本地图片上传到 CloudFlare ImgBed 图床,并自动替换为在线链接。
功能特点
- 自动上传本地图片到 CloudFlare ImgBed 图床
- 自动替换 Markdown 文件中的本地图片路径为在线链接
- 支持指定上传渠道(telegram / cfr2 / s3 / discord / huggingface / webdav)
- 支持指定上传目录
- 支持配置是否清空图片描述文本
使用前准备
- 部署或获取一个 CloudFlare ImgBed 实例,并准备好上传认证码(authCode)或具备
upload 权限的 API Token
- 在 VSCode 设置中完成配置:
- 打开设置(Ctrl+,)
- 搜索 "Markdown Image Uploader"
- 填入你的图床地址(Base URL)和上传认证码
配置选项
| 配置项 |
必填 |
说明 |
markdownImageUploader.baseUrl |
✅ |
图床地址,例如 https://your.domain(不要带末尾的 /upload) |
markdownImageUploader.authCode |
✅ |
上传认证码(authCode)或具备 upload 权限的 API Token(imgbed_ 开头)。两种填法都支持,扩展会自动适配 |
markdownImageUploader.uploadChannel |
可选 |
上传渠道,留空则使用服务端默认(telegram)。可选 telegram、cfr2、s3、discord、huggingface、webdav |
markdownImageUploader.uploadFolder |
可选 |
上传目录(相对路径),例如 img/test,留空则上传到根目录 |
markdownImageUploader.clearImageDescription |
可选 |
是否在上传时清空图片描述(方括号内的内容,默认 false) |
关于认证:服务端同时支持「上传认证码」和「API Token」两种方式。无论你在 authCode 里填的是哪一种,扩展都会同时通过请求头和查询参数发送,服务端会自动匹配,因此你不需要关心自己用的是哪种凭据。
使用方法
- 打开一个 Markdown 文件
- 使用以下任一方式上传图片:
- 方式一:右键点击编辑器,选择 "Upload Images to ImgBed"
- 方式二:按下
F1 或 Ctrl+Shift+P 打开命令面板,输入 "Upload Images to ImgBed"
- 插件会自动上传文件中的所有本地图片并替换链接
注意事项
- 只会处理本地图片,已经是在线链接的图片会被跳过
- 请确保已正确配置
baseUrl,否则无法上传
- 请确保本地图片路径正确且文件存在
- 支持任意层级的相对路径,图片在子目录(如
assets/sub/pic.png)或上级目录(如 ../shared/pic.png)都能正确识别
- 路径中包含空格、中文或 URL 编码(如
%20)也能正常处理
调试与开发
想在本地修改代码并实时调试,请参考 DEBUG.md。
问题反馈
如果你遇到任何问题或有功能建议,欢迎在 GitHub 上提交 Issue。
| |