Markdown 图片直传 R2
/install md-img-r2
md-img-r2
将 Markdown 文件中的本地图片直接上传到 Cloudflare R2,并把本地路径替换为公开 URL。
适用场景
- 你已经有 Cloudflare R2 桶和可公开访问域名
- 你不想依赖 PicList Desktop
- 你希望把这个能力作为可分发 skill 交给别人使用
前置条件
- 已有可写入的 Cloudflare R2 凭证
- 已有桶名和公开访问域名或 CDN 域名
- 运行环境有
python3
推荐配置
优先用环境变量或项目根目录的 .env 提供配置:
CF_R2_ACCOUNT_IDCF_R2_ACCESS_KEY_IDCF_R2_SECRET_ACCESS_KEYCF_R2_BUCKETCF_R2_PUBLIC_BASE_URLCF_R2_REGION,默认autoCF_R2_ENDPOINT,默认https://\x3Caccount_id>.r2.cloudflarestorage.comCF_R2_KEY_PREFIX,默认md-assets--env-file可显式指定.env路径;不传时会优先读取 skill 目录下的.env,再从目标目录向上查找
用法
单文件
bash run.sh path/to/article.md
目录批处理
bash run.sh path/to/dir --recursive
Dry run
bash run.sh path/to/article.md --dry-run
临时覆盖 key 前缀
bash run.sh path/to/article.md --key-prefix posts/2026-04
输出
- 默认原地修改,并生成备份:
xxx.md.bak - 生成报告:
xxx.md.replace-report.json
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install md-img-r2 - After installation, invoke the skill by name or use
/md-img-r2 - Provide required inputs per the skill's parameter spec and get structured output
What is Markdown 图片直传 R2?
Upload local images in Markdown directly to Cloudflare R2 and replace paths with public URLs. It is an AI Agent Skill for Claude Code / OpenClaw, with 56 downloads so far.
How do I install Markdown 图片直传 R2?
Run "/install md-img-r2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Markdown 图片直传 R2 free?
Yes, Markdown 图片直传 R2 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Markdown 图片直传 R2 support?
Markdown 图片直传 R2 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Markdown 图片直传 R2?
It is built and maintained by Sundy Yang (@yangchao228); the current version is v1.0.3.