Typora + PicGo + Gitee 配置指南

最近一直在使用Typora写作，这款软件编写markdown的体验确实好到飞起。但用Typora写作有个问题，文章中插入的图片在文档进行传输和共享的时候不是很方便，使用离线的方式在传输文档时要同时将图片进行打包，另外如果将写好的文档直接上传到CSDN等博客时图片会找不到。Typora为了解决这个问题本身就自带了将文档中的图片自动上传到公网图床的方法，需要PicGo软件和图床网址的配合。在网上搜到了Typora + PicGo + Gitee的配置方案，但经过参考几个文章下来，始终没有成功，每个文章多少都有点问题。最后经过自己查找资料加不断尝试，终于配置成功，现将整个过程再做个总结整理。

​ 整个过程主要分为3步：Gitee仓库建立、PicGo安装配置、Typora配置。

Gitee仓库配置

注册账户

创建仓库

创建一个仓库，可以只保留一个单分支master，注意仓库必须是开源的（新版gitee要求开源的设置必须在创建完成后在仓库设置中进行修改）。

生成私人令牌

进入设置->私人令牌

按下图创建令牌

生成后的令牌token在这里一定要先复制出来保存好。

PicGo安装配置

PicGo，一个用于快速上传图片并获取图片 URL 链接的工具。

下载

中文站点：https://molunerfinn.com/PicGo/

建议下载2.3.0最后一个稳定版

根据操作系统选择相应的安装包，如Windows下选择PicGo-Setup-2.3.0-x64.exe

安装

安装比较简单，一路下一步。安装好后启动，可以在操作系统任务栏中打开如下图所示。

安装Gitee插件

PicGo内置了几种图床插件，但不包含Gitee的，需要自行安装。经过我的几次尝试，目前发现的能够成功匹配到Gitee仓库的插件是gitee-smart。

1. 在插件管理中搜索gitee，找到gitee-smart并安装。
   

2. 配置SM.MS图床。

   由于Gitee的权限机制问题，必须借助SM.MS图床才能成功上传图片到Gitee。

   注册SM.MS账户并获取到SM.MS的token。

   地址： https://sm.ms/login
   注册用户后在如下图位生成token。
   
   

   在PicGo中配置SM.MS图床，将得到的token填入。
   

3. 在图床设置中对gitee插件进行如下配置
   

• repo：仓库的地址，填写形式为gitee用户名/gitee仓库名。此处的用户名是gitee真实的账户名，不是昵称，判断方法为从仓库的克隆地址中获取。

• branch：上传到的仓库分支，保持默认即可。
• token：在配置Gitee仓库时生成的私人令牌。
• path：此处必填（不填会在图片上传时报错，不知道为什么）。
• customPath\customUrl：不用管。

注意一定要点设为默认图床选项。

Typora配置

进入Typora的文件->偏好设置->图片，按下图所示进行设置

设置好后可以点击验证图片上传选项进行验证，如果提示成功则说明已经配置好了。

后续在文档中插入的图片会自动上传到gitee仓库并用公网的地址进行替换。对于已有文档中的本地图片引用也可以手动右键进行图片上传，如下图所示：