帮助中心

Typora 配置 Picmo 图床

2026 年 10 月 30 日 · 约 6 分钟读完

Typora 支持「插入图片时自动上传」,配合 PicGo 可以把每次粘贴的截图直接变成 Picmo 的直链。配置只需要做一次,之后写作全程不用离开键盘。

一、准备

  • Typora(任意较新版本);
  • PicGo 客户端(官网下载,Windows / macOS 都有);
  • 一个 Picmo 账号,用于生成 API Token。

二、在 Picmo 获取 Token

登录后进入「控制台 → API 令牌」,新建一个令牌并复制。令牌相当于密码,不要发到公开仓库里。

三、在 PicGo 里添加自定义图床

PicGo 内置列表里没有 Picmo,需要装「picgo-plugin-web-uploader」插件,或者直接用「自定义命令」调用 Picmo 的上传接口。以插件方式为例:

  1. 打开 PicGo → 插件设置 → 搜索并安装 picgo-plugin-web-uploader;
  2. 图床设置里选择这个插件,API 地址填 https://www.picmo.cn/api/v2/upload;
  3. 请求方式选 POST,表单字段名填 file;
  4. 自定义请求头加上 Authorization: Bearer 你的Token;
  5. 返回格式填 JSON,提取路径填 data.links.url。

保存后点「上传测试」,PicGo 会在相册里出现一张图,说明链路通了。

四、在 Typora 里接上 PicGo

  1. Typora → 文件 → 偏好设置 → 图像;
  2. 「插入图片时」选择「上传图片」;
  3. 「上传服务」选择 PicGo(app),路径指向你安装的 PicGo 可执行文件;
  4. 点「验证图片上传选项」,出现成功提示即可。

之后在 Typora 里截图粘贴,图片会自动上传并替换成直链。

五、常见问题

  • 验证失败:先确认 PicGo 里的上传测试能通过,再检查 Typora 里的 PicGo 路径是否正确;
  • 上传成功但链接是本地路径:说明 Typora 没有把「上传图片」设为默认行为,检查偏好设置第一项;
  • 提示 401:Token 复制时多了空格,或者令牌已被删除,重新生成一个;
  • 图片能传但显示 404:检查返回的链接是否包含 /uploads/,若缺少说明提取路径填错了。

如果你用的不是 Typora,而是 Obsidian、VS Code、思源笔记,思路完全一样:找「图片上传」设置,接 PicGo,PicGo 里接 Picmo。