使用Typora+PicGo+Gitee打造全新Markdown博客创作环境
文章目录
第一部分：概述1.1 问题来源1.2 软件简介 第二部分：实现2.1 软件下载2.2 GiTee账户令牌与仓库创建2.3 PicGo配置工作2.4 Typora配置工作 第三部分：总结3.1 关于创作3.2 本文修订记录3.3 本文所使用的各个软件版本 第四部分：参考资料第一部分：概述
1.1 问题来源
工欲善其事，必先利其器。
本文主要解决markdown图片自动上传个人托管平台，并以链接形式记录在markdown中，提高markdown复用性的问题。
demo
很多领域作者喜欢使用Markdown格式文本进行创作，这是一种轻量级的标记语言，具有以下几个显著优点：
编写方便，语法规则简单易懂。支持多种对象类型，例如编号，图片，图表，数学公式等。支持多平台，尤其对于html兼容，很适合写在线帮助文档或者论坛博客知识共享。
对于图片类型的对象，在markdown中记录时，常常需要指定图片的本地或在线路径，这就带来一些问题：
如果采取本地图片路径，则对于知识共享很不方便。如果采用远程url图片路径，则需要先将图片上传网络，然后粘贴图片的站外链接。如果创作者需要将文章发布在多个平台，则需要重复上传，这是一件令人费力的事情。
为了解决上述问题，最好的办法是将图片变成一个个链接，用引用图片url的方式写在markdown文本中，这样一来，只要浏览文章的主机可以连网，那么不论在哪个平台，都可以在编辑器中看到markdown中渲染的图片，这是创作者尤其是喜欢在多个平台共享知识的创作者的福音。
使用Typora+PicGo+Gitee可以实现上述操作，Typora是编辑器，PicGo是图床，可以建立编辑器与托管平台的连接，Gitee是图片托管平台，读完本文之后，读者可以有以下收获：
实现markdown中的图片自动上传托管平台，并在文档中将本地图片自动转化为远程图片URL路径。实现文档的多平台兼容共享，尤其是在展示图片时。文档中的图片免费托管，且所有图片均在用户账户下，可以随时下载或者查看。
本文适合以下用户：
准备进行博客创作的小白需要提高创作效率的领域作者希望解决markdown图片上传与备份问题的其他用户
1.2 软件简介
Typora：是一款轻便好用的Markdown编辑器，支持实时渲染，没有采用源代码和预览双栏显示，采用“所见即所得”的设计模式。笔者选择它的理由主要有三个：
写下来的文字就是渲染后的样子，跟word很像，简单易用。大纲目录展示功能，并且可以分层级进行模块折叠，这对于写长篇文章或帮助创作者理清思路很有帮助。功能多样，支持丰富的段落模式，以及PDF等多种格式的导出文件。
PicGo：一个用于快速上传图片并获取图片URL链接的工具，支持多种图床，在本文中，我们用到的是Gitee图床。相关特性可以移步到官网。可以作为连接编辑器和图片托管平台的工具。
Gitee：目前国内最大的代码托管工具，同时也支持图片的上传，有点像Github。笔者尝试过类似七牛云或者BAT等云的托管平台，发现还需要购买个人域名或存储空间，比较麻烦，相比之下，Gitee做的很优秀。
第二部分：实现
2.1 软件下载
Typora的下载安装和激活可以参考这篇文章或者其他博客，这里主要介绍PicGo的安装过程。
打开Typora，依次单击菜单栏【文件】=>【偏好设置】=>【图像】，会在页面上展示【下载PicGo】按钮，单击即可跳转下载页面。因为这里笔者做了主题颜色的修改，所以软件的背景是深色的，这个基本不影响本文的阅读。
在下载页面中单击【免费下载】，会跳转到github相应网站，下拉可以看到下载链接：例如笔者选择【PicGo-Setup-2.3.1.exe】这一项。
接下来就是程序安装过程，可以自定义程序的安装路径，这些操作比较简单。
注意如果想要正常使用PicGo，可能还需要安装NodeJS环境，可以下载左侧稳定板，这个过程也是按部就班，按照提示进行安装即可。
以上软件安装完毕后，就可以进行仓库的创建。
2.2 GiTee账户令牌与仓库创建
Gitee账户的准备工作有以下几项工作需要做：
创建账户创建项目（也就是仓库）修改仓库权限为公开生成私人令牌
如果读者还没有Gitee账户，需要先创建Gitee账户，如果已有账号，可以直接登录。
然后需要创建一个公开仓库，按照以下操作进行配置。
首先新建仓库
配置仓库相关参数，这里暂时还不能修改仓库权限。
新版Gitee无法再创建时选择权限，需要创建后在仓库设置中选择公开。在仓库界面单击选择【管理】，并且勾选相关单击【确定】。
进入仓库主页。
进入仓库设置页面。
设置仓库权限为开源。
接下来需要设置私人令牌，这个令牌相当于暗号或者密码，外部可以通过这个另外访问到当前账户下的数据，注意明文令牌只展示一次，需要及时保存在粘贴板中，后续要用到。
进入个人主页设置。
在设置页面左侧找到【私人令牌】。
添加私人令牌。
配置私人令牌参数。
注意令牌明文只展示一次，需要记录下来，后面要用。
到此为止，Gitee仓库创建完成，个人的令牌也已经生成，接下来就是要把账户（Gitee用户名和仓库名）和密码（私人令牌）写在PicGo中。
2.3 PicGo配置工作
打开PicGo软件，做必要的安装配置。
安装gitee－uploader插件设置gitee相关账户、仓库和令牌设置PicGo软件
首先需要在【插件设置】中安装gitee插件，搜索gitee-uploader并单击安装，等待几分钟安装完毕。
安装后重启PicGo，可以在【图床设置】选项中看到下拉选项【Gitee】，单击并进行配置。
有以下几项：
repo：在自己的Gitee账户下，单击刚刚创建的根目录，在浏览器的当前页面链接中复制最后的账户名和仓库名部分，例如笔者的这一栏填“softargmax/blog-pic”。branch：一般选择mastertoken：刚才在剪贴板中粘贴的私人令牌，直接复制过来其他：保持默认即可
注意账户名和仓库名要粘贴红色框里面的。
配置完毕后，单击【设为默认图床】和【确定】
对PicGo进行一些其他的设置，正常情况下，【设置Server】中的监听网址保持默认就好。
在设置server中，默认应该是这样的IP配置，如果不是就修改成这样。
2.4 Typora配置工作
这是最后一步，配置Typora，主要有以下工作：
设置插入图片的时执行的操作为【上传图片】，并设置相应动作配置上传服务为PicGoAPP，并且选择程序所在的安装路径单击相应按钮进行验证测试
返回刚才打开的PicGo的偏好设置，在【图像】界面进行设置：
设置完成后，可以单击【验证图片上传选项】按钮，证实自己的操作是正确的。
如果出现红色的faild字样，说明以上配置存在错误，可以从以下几个方面排查：
检查仓库的权限是否被修改为公有检查PicGo中的Gitee配置是否和账户中的情况一致，尤其是账户名和仓库名要选择从链接中粘出来的而不是别的重启各个软件再次尝试。
如果提示出现successful字样，则说明上述配置成功。具体使用时，有以下现象：
在使用Typora编写markdown文档时，不论以何种方式（例如选择本地文件或者其他网页的url文件）添加图片，图片都会自动上传到自己Gitee账户下的仓库中，并且在markdown中将链接地址修改为该图片的Gitee外往访问链接，这些链接是可以通过python或其他方式进行自动爬虫同步本地的，当然也可以自己登录仓库下载，也就意味着本地不需要再保存markdown中用到的图片了。打开仓库，可以看到按照时间戳排序的各个图片文件，可以供用户批量下载备份。在PicGo的【相册】栏目中也会出现通过该软件上传过的图片。
第三部分：总结
3.1 关于创作
本文主要解决使用markdown编写文档时，图片的自动上传和备份问题。读者可以通过以上方式初步搭建自己的创作平台，方便自己的文章在各个平台进行备份，并且保证自己的创作的文章中的各个元素尤其是图片不丢失。
本文基于一些现有的博客进行改写，所以需要感谢这些前辈提供的宝贵思路，本文创建于底，后续随着各个软件的版本更新，难免会有一些操作和本文不一致的地方，但是大体上流程和本文是一致的，本文的所有操作流程都是笔者亲身实践，如有谬误或不全面的地方，欢迎读者多多指教。
希望这篇文章可以帮助到有需要的读者。
3.2 本文修订记录
3.3 本文所使用的各个软件版本
Typora：1.0.3
PicGo：2.3.1
Gitee：网站形式，1115版
第四部分：参考资料
Typora+PicGo+Gitee搭建博客写作环境（超详细）
