Markdown 文档图片自动上传 Gitee 图床：Typora + PicGo 完美方案

内容摘要：Markdown 文档图片自动上传 Gitee 图床：Typora + PicGo 完美方案,

在编写 Markdown 文档时，图片管理一直是个令人头疼的问题。如果直接使用本地图片路径，分享给他人或者在其他设备上查看时，图片就会失效。为了解决这个问题，我们可以利用 Typora + PicGo + Gitee 搭建一个 Markdown 文档图片自动上传图床的方案，实现图片的集中管理和统一访问。

底层原理：PicGo 如何助力图片上传？

PicGo 是一款开源的图床工具，支持多种图床平台，例如 GitHub、Gitee、阿里云 OSS、腾讯云 COS 等。它的核心功能是将本地图片上传到指定的图床平台，并返回图片的 URL 地址。通过 PicGo，我们可以方便地将 Markdown 文档中的本地图片自动上传到图床，从而避免图片链接失效的问题。

Gitee 图床：国内用户的理想选择

对于国内用户来说，Gitee 是一个不错的图床选择。Gitee 提供了免费的私有仓库，我们可以利用它来存储图片。相比于 GitHub，Gitee 在国内访问速度更快，更加稳定。

Typora：Markdown 编辑器的完美搭档

Typora 是一款简洁、高效的 Markdown 编辑器。它支持实时预览，可以让我们在编写 Markdown 文档的同时，实时查看效果。Typora 还可以与 PicGo 无缝集成，实现图片的自动上传。

具体配置步骤：手把手教你搭建图片自动上传图床

1. 注册 Gitee 账号并创建仓库 首先，需要在 Gitee 上注册一个账号，并创建一个私有仓库，用于存储图片。

   

2. 安装 PicGo 从 PicGo 官网下载并安装 PicGo。

3. 配置 PicGo

   

   • 打开 PicGo，选择“插件设置”，搜索并安装“gitee-uploader”插件。
   • 在“图床设置”中，选择“Gitee”，并填写以下信息：
     • repo: 仓库名，格式为 用户名/仓库名
     • token: Gitee 的私人令牌（需要在 Gitee 上生成）
     • branch: 分支名，一般为 master
     • path: 存储路径，例如 img
     • customUrl: 自定义域名（可选）
   • 点击“确定”保存配置。

{
  "repo": "your_username/your_repo", // 替换成你的仓库名
  "token": "your_gitee_token", // 替换成你的 Gitee 私人令牌
  "branch": "master",
  "path": "img", // 图片上传到仓库的 img 目录下
  "customUrl": "",
  "name": "gitee"
}

4. 安装 Typora 从 Typora 官网下载并安装 Typora。

5. 配置 Typora

   

   • 打开 Typora，选择“文件” -> “偏好设置” -> “图像”。
   • 在“插入图片时”选项中，选择“上传图片”。
   • 在“上传服务设置”中，选择“PicGo(app)”。
   • 配置 PicGo 的路径（如果 Typora 没有自动识别）。

实战避坑经验总结：那些年踩过的坑

• Gitee 私人令牌权限问题：确保你的 Gitee 私人令牌拥有 repo 权限，否则 PicGo 无法上传图片。
• PicGo 上传失败：检查 PicGo 的配置是否正确，特别是 repo 和 token 是否填写正确。同时，也要检查网络连接是否正常。可以使用 ping gitee.com 命令检测网络连通性。也可以尝试更换 PicGo 的版本，有些版本可能存在兼容性问题。
• Typora 图片无法显示：检查 Typora 的配置是否正确，确保 Typora 可以找到 PicGo 的安装路径。此外，也要检查 Markdown 文档中的图片链接是否正确，例如是否缺少 ! 前缀。
• Gitee 仓库容量限制：Gitee 私有仓库有容量限制，如果上传的图片过多，可能会超出容量限制。可以考虑使用其他图床平台，例如阿里云 OSS 或腾讯云 COS。
• 高并发场景下的性能瓶颈：如果需要处理大量图片的上传，单台 PicGo 可能无法满足需求。可以考虑使用 Nginx 做反向代理和负载均衡，将请求分发到多台 PicGo 服务器上，从而提高上传效率。

进阶技巧：优化你的图床体验

• 使用 CDN 加速：为了提高图片的访问速度，可以使用 CDN (Content Delivery Network) 对 Gitee 图床进行加速。CDN 可以将图片缓存到离用户最近的节点，从而减少访问延迟。国内常用的 CDN 服务商有阿里云 CDN、腾讯云 CDN 等。
• 图片压缩优化：在上传图片之前，可以使用图片压缩工具对图片进行压缩，减小图片的大小。常用的图片压缩工具有 TinyPNG、ImageOptim 等。这不仅可以节省 Gitee 仓库的容量，还可以提高图片的加载速度。
• 自动化脚本：可以编写自动化脚本，例如使用 Python 脚本调用 PicGo 的 API，实现批量上传图片的功能。这对于处理大量图片时非常有用。

希望以上内容能帮助你搭建一个高效、稳定的 Markdown 文档图片自动上传 Gitee 图床，提升你的写作体验！