Typora+PicGo+Gitee图床配置教程 自动图片上传

配置步骤

详细配置指南

1. 软件准备

• 安装Typora：官方下载链接
• 安装PicGo：GitHub下载链接
• 注册Gitee账号：Gitee官网

2. Gitee仓库配置

1. 登录Gitee后创建新仓库（如pik-bed）
   • 访问：创建新仓库
2. 确保仓库设置为"公开"（极其重要）
   • 点击"管理" → “仓库设置” → 仓库类型选择"公开"
3. 创建Token
   • 访问：个人访问令牌
     右上角头像==》设置==》私人令牌
   • 创建新Token，确保勾选"projects"权限

3. PicGo配置

1. 安装Gitee插件

   • 打开PicGo → 插件设置 → 搜索"gitee" → 安装"gitee-uploader"
   • 插件链接：picgo-plugin-gitee-uploader

2. 配置Gitee图床

   • 图床设置 → Gitee图床
   • 填写以下信息：

     owner: 你的Gitee用户名（如zhou-zhou110）
     repo: 仓库名（如pik-bed）
     branch: master
     token: 步骤2创建的Token
     path: img/{y}{m}{d}  （添加时间戳防止文件重名）
     customUrl: https://gitee.com/你的用户名/仓库名/raw/master
     

     

3. 启用时间戳
   

4. Typora配置

1. 打开Typora → 文件 → 偏好设置 → 图像
2. 上传服务设定为"PicGo(app)"
3. PicGo路径指向你的PicGo安装位置（如D:\Program Files\PicGo\PicGo.exe）
4. 点击"验证图片上传选项"测试配置

5. 常见问题排查

上传失败错误：

• “更新失败”（错误400）：检查图片是否已存在，或token权限是否足够
• “Access denied”：确认仓库已设为公开，且分支名称正确
• 图片上传成功但显示不出：检查Typora生成的链接是否正确，可能需要手动修复链接格式
• PicGo未生成正确时间戳：确认path格式正确，重启PicGo尝试
• PicGo日志位置：C:\Users\用户名\AppData\Roaming\picgo\picgo.log

图片URL格式：

正确的URL应该是：

https://gitee.com/用户名/仓库名/raw/master/img/年月日/图片名.png

最好不打开typora的图片自动上传，使用手动全部上传

6. 最佳实践

• 使用时间戳格式避免文件名冲突
• 定期清理不再使用的图片：Gitee文件管理
• 备份重要的Markdown文档和图片
• 在上传前压缩图片，避免超过Gitee限制（单文件通常限制为50MB）
• 参考PicGo官方问题排查：常见问题

7. 其他备选图床

如Gitee出现问题，可考虑以下替代方案：

• GitHub + PicGo-GitHub插件
• 七牛云 + PicGo-七牛插件
• 腾讯云COS + PicGo-腾讯COS插件

按照以上步骤配置后，你就可以在Typora中直接粘贴图片，它们会自动上传到Gitee并插入正确的链接格式。