Typora + PicGo图床配置完全教程：Markdown图片自动上传云端

为什么Typora需要配置图床

Typora是优秀的Markdown编辑器，但默认情况下，插入的图片会以本地路径引用。这意味着：

• 文档分享给他人时，图片显示为「裂图」
• 发布到博客或GitHub时，图片无法加载
• 多台设备间同步文档，图片路径容易失效
• 备份文档时容易遗漏图片文件夹

图床（Image Hosting）就是为解决这些问题而生的。将图片上传到云端服务器后，文档中引用的是网络URL，无论文档发到哪里，图片都能正常显示。

PicGo是一款开源的图床管理工具，与Typora完美配合，可以实现图片的自动上传和URL替换。

安装PicGo

下载PicGo

1. 访问PicGo官方GitHub仓库（github.com/Molunerfinn/PicGo）
2. 在Releases页面下载最新版本
3. 根据系统选择对应安装包：
   • Windows：.exe安装程序
   • macOS：.dmg镜像文件
   • Linux：.AppImage或.deb/.rpm

安装步骤

Windows安装

1. 双击下载的.exe文件
2. 按安装向导完成安装
3. 安装完成后在任务栏找到PicGo图标

macOS安装

1. 打开.dmg文件
2. 将PicGo拖入「应用程序」文件夹
3. 首次启动时需要在「系统设置」→「隐私与安全性」中允许

验证安装

打开PicGo后，在任务栏/菜单栏找到PicGo图标，点击打开主界面：

1. 左侧显示「上传区」「相册」「图床设置」「PicGo设置」「插件设置」
2. 确认界面正常显示，无报错信息

配置图床

PicGo支持多种图床，以下是几种常见图床的配置方法。

方案一：GitHub图床（免费，推荐）

GitHub图床完全免费，适合个人博客和技术文档。

前期准备

1. 注册GitHub账号（如果还没有）

2. 创建新仓库：

   • 登录GitHub → 点击右上角「+」→「New repository」
   • 仓库名称如 images 或 picbed
   • 设置为 Public（私有仓库图片外链无法访问）
   • 勾选「Add a README file」
   • 点击「Create repository」

3. 获取Token：

   • 点击右上角头像 →「Settings」
   • 左侧最下方「Developer settings」
   • 「Personal access tokens」→「Tokens (classic)」
   • 点击「Generate new token (classic)」
   • Note填写如「PicGo」
   • Expiration选择「No expiration」（或按需设置）
   • 勾选「repo」权限
   • 点击「Generate token」
   • 立即复制保存token（关闭页面后无法再次查看）

PicGo中配置GitHub图床

1. 打开PicGo →「图床设置」→「GitHub图床」
2. 填写以下信息：

3. 点击「确定」保存
4. 点击「设为默认图床」

使用jsDelivr CDN加速（可选）

GitHub图片在国内访问速度较慢，可以使用jsDelivr免费CDN加速：

• 自定义域名填写：https://cdn.jsdelivr.net/gh/用户名/仓库名@分支名
• 例如：https://cdn.jsdelivr.net/gh/yourname/images@main

方案二：阿里云OSS（付费，稳定）

阿里云OSS适合对稳定性要求高的商业用户。

前期准备

1. 注册阿里云账号

2. 开通OSS服务

3. 创建Bucket：

   • 进入OSS控制台
   • 点击「创建Bucket」
   • Bucket名称全局唯一（如 yourname-picbed）
   • 地域选择离用户最近的
   • 读写权限选择「公共读」
   • 创建完成

4. 获取AccessKey：

   • 鼠标悬停右上角头像 →「AccessKey管理」
   • 创建AccessKey
   • 保存AccessKey ID和AccessKey Secret

PicGo中配置阿里云OSS

1. 打开PicGo →「图床设置」→「阿里云OSS」
2. 填写：

3. 保存并设为默认

方案三：腾讯云COS（付费，稳定）

配置流程与阿里云类似：

1. 注册腾讯云账号
2. 开通COS服务
3. 创建存储桶（权限设为公有读私有写）
4. 获取SecretId和SecretKey
5. 在PicGo中配置腾讯云COS图床

Typora中配置PicGo

打开Typora图片上传设置

1. 打开Typora
2. 进入「文件」→「偏好设置」（或按Ctrl+,）
3. 切换到「图像」标签页

配置上传服务

在「插入图片时」区域：

1. 选择「上传图片」

2. 勾选以下选项：

   • ☑️ 「对本地位置的图片应用上述规则」
   • ☑️ 「对网络位置的图片应用上述规则」
   • ☑️ 「允许根据YAML设置自动上传图片」（可选）

3. 在「上传服务」下拉菜单中选择「PicGo(app)」

4. 点击「验证图片上传选项」测试配置

测试上传功能

1. 点击「验证图片上传选项」
2. Typora会自动上传一张测试图片
3. 如果显示「验证成功」，说明配置完成
4. 如果失败，检查PicGo是否运行、图床配置是否正确

自动上传设置

配置完成后，Typora会在以下场景自动上传图片：

使用PicGo上传图片

方式一：Typora自动上传（推荐）

配置完成后，在Typora中的操作和往常一样：

1. 截图后粘贴到Typora → 自动上传到图床
2. 拖拽图片到Typora → 自动上传
3. 原有的本地图片 → 在Typora中右键图片 →「上传图片」

Typora会自动将本地路径替换为图床URL。

方式二：PicGo手动上传

1. 打开PicGo主界面
2. 在「上传区」拖拽图片文件
3. 或点击剪贴板图片按钮上传剪贴板中的图片
4. 上传成功后，URL会自动复制到剪贴板
5. 在Typora中粘贴即可

方式三：快捷键上传

PicGo支持全局快捷键：

可以在PicGo设置中自定义快捷键。

图床管理与维护

PicGo相册功能

PicGo内置相册管理：

1. 点击「相册」标签
2. 查看所有已上传的图片
3. 点击图片可预览、复制URL、删除
4. 支持按图床筛选查看

批量管理图片

1. 在相册中多选图片（Ctrl+点击或Shift+点击）
2. 批量复制URL、删除、重命名
3. 删除操作会同步到图床服务器

防止图片丢失

虽然图床提供了便利，但也有风险：

1. 定期备份：重要图片在本地保留一份备份
2. 不要只依赖免费图床：GitHub等免费服务政策可能变化
3. 监控图片链接：定期检查文档中的图片是否能正常加载
4. 使用稳定图床：重要文档建议使用付费稳定服务

常见问题与解决

上传失败：404/403错误

图片上传后Typora中不显示

1. 检查Typora是否切换为「上传图片」模式
2. 确认PicGo正在运行
3. 尝试在浏览器中直接访问图片URL
4. 检查是否被防火墙或安全软件拦截

PicGo端口冲突

Typora默认通过36677端口与PicGo通信，如果该端口被占用：

1. 打开PicGo →「PicGo设置」→「设置Server」
2. 修改端口号（如36678）
3. 在Typora中配置对应的端口号

上传后URL格式不对

如果Typora中图片URL显示不正确：

1. 检查PicGo「PicGo设置」→「自定义链接格式」
2. 确保格式为标准的Markdown图片语法：![alt](url)
3. 或选择「不设置自定义链接格式」让Typora处理

高级技巧

使用PicGo插件扩展功能

PicGo支持插件生态，可以扩展更多功能：

1. 打开PicGo →「插件设置」
2. 搜索需要的插件，如：
   • picgo-plugin-compress：上传前压缩图片
   • picgo-plugin-watermark：自动添加水印
   • picgo-plugin-rename-file：自定义文件名
3. 点击安装并配置

配置图片压缩

如果上传的图片体积过大：

1. 安装picgo-plugin-compress插件
2. 在插件设置中配置压缩参数
3. 上传时自动压缩，节省图床空间和流量

多台电脑同步PicGo配置

PicGo的配置文件存储在：

• Windows：C:\Users\用户名\AppData\Roaming\PicGo\data.json
• macOS：~/Library/Application Support/PicGo/data.json
• Linux：~/.config/PicGo/data.json

可以将此文件同步到云盘，实现多设备配置同步。

总结

Typora + PicGo的组合是Markdown写作中管理图片的最佳方案。通过配置图床，你可以实现图片的自动上传和云端管理，让文档分享和发布变得无比顺畅。无论是选择免费的GitHub图床，还是稳定的云厂商OSS，PicGo都提供了简单易用的配置界面。建议按照本文步骤逐步配置，并在配置完成后进行上传测试，确保整个流程正常工作。配置一次，长期受益，从此告别Markdown文档中的「裂图」困扰。