md文档自动上传图片

110 阅读3分钟

解决问题:掘金等平台上传md文件,无法显示图片的问题

原因分析:

你在本地写的 Markdown 文件中引用的是 C:\xxx\图片.png 或相对路径,发布时这些图片不在公网,别人看不到。

image-20251024104031889

解决办法:picgo+aliyun_oss

image-20251024103832963

先使用aliyun的oss对象存储,之前会的可以跨过本步骤,没了解过的建议先学习一下,

经常用到云端存储。

配置aliyun_oss

第一步:准备阿里云 OSS 资源

  1. 登录阿里云控制台

👉 home.console.aliyun.com

  1. 创建或选择一个 Bucket
  • 进入 OSS 控制台

  • 点击「创建 Bucket」

    • 名称:如 my-blog-images

    • 地域(Region) :选离你近的,比如 华东2(上海)oss-cn-shanghai

    • 权限

      • 读写权限:公共读(Public Read)
      • ⚠️ 私有会无法直链访问

💡 记下这两个信息:

  • Bucket 名称:my-blog-images
  • 地域代码:oss-cn-shanghai

第二步:创建 AccessKey(安全密钥)

⚠️ 不要用主账号 AK!建议创建子账号

方案 A:使用主账号(快速但风险高)

  1. 右上角头像 → “AccessKey 管理”
  2. 获取你的:
    • AccessKey ID(形如 LTAI5t******
    • AccessKey Secret(一定要保存好!只能看一次)

方案 B:推荐!使用 RAM 子账号(更安全)

1. 进入 RAM 访问控制

👉 ram.console.aliyun.com

2. 创建用户

  • 用户名:picgo-user
  • 访问方式:勾选「编程访问」✅
  • 不开启控制台登录 ❌

3. 授权策略

给它绑定以下权限:

  • AliyunOSSFullAccess(允许操作 OSS)
  • 或自定义策略(限制仅某个 bucket)

4. 生成 AccessKey

  • 创建后生成 AK 和 SK
  • 下载 CSV 保存(Secret 只显示一次)

📌 记住这 4 个关键信息:

AccessKey ID:     LTAI5t***************
AccessKey Secret: vDQf***************
Bucket:           my-blog-images
Region:           oss-cn-shanghai

配置picgo

第三步:安装并配置 PicGo

  1. 下载官方最新版 PicGo

👉 GitHub 官方地址:github.com/Molunerfinn… 选择适合你系统的版本(Windows/macOS/Linux)

✅ 必须是官方版!绿色版/魔改版可能没有日志功能。


  1. 打开 PicGo,配置阿里云 OSS

进入:设置 → 图床 → 选择“阿里云OSS”

image-20251024103005795

其中,图床配置名任意。 剩下的使用刚才配置的oss

3.设置为默认使用,然后在上传区进行测试链接是否正确

如果显示失败,可以打开picgo的log打印文件查找问题。

注意:我开始一直出错,通过查看打印log,发现是无法访问,ai说能识别路径,但是无法访问,是密码错了,但是我可以肯定密码没问题。经过检查发现是我使用了一个我bucket里不存在的路径!

配置typora

最后,只需要打开文件=》找到偏好设置=》插入图片时=》选择上传图片

然后上传服务选择picgo app,如果系统识别不到picgo.exe,需要手动选择路径

image-20251024103544254

完成后,点击验证,如果没问题,本次问题就解决啦!

以后你每次在typora上插入图片时,它会自动将图片上传到图床,然后引用的图片链接,是可以通过网络访问的。

image-20251024103832963