使用Gitee搭建免费的Markdown图床

1,498 阅读3分钟

0 背景

Markdown是一种广受欢迎的轻量级标记语言,它允许人们使用纯文本格式编写文档。凭借简单的语法,优雅的样式,Markdown饱受程序员们的青睐。

但也正因为Markdown的轻量,Markdown对图片的支持是通过插入图片地址的形式插入图片的,图片可以是本地或网上的图片。对于本地图片,在将文档发送给别人时,还要将图片一同打包;对于网络图片,难免遇到长时间后网络图片找不到的情况。因此,我们设法通过自建图床的方法,将Markdown中插入的图片进行自动上传并插入。

常用图床有GitHub、国内的Gitee、各种云服务器等。考虑到国内的网络环境与易用程度,在此我使用Gitee来搭建图床。

1 Gitee创建仓库

Gitee(码云)是国内知名的代码托管平台,使用方法与GitHub类似,在此不做过多说明。

1.1 创建仓库

在gitee上创建一个新的仓库,名称可自定。

  • 注意权限要选择开源,否则可能会导致你的图片不能被别人看到。
  • 为了方便,我直接勾选了设置模板,这里可以自选。

image-20211102112518012

为了管理方便,我在仓库根目录下创建一个images目录来保存上传的图片。

1.2 生成个人令牌

进入gitee设置页,点击右侧私人令牌,点击右上角生成新令牌

image-20211102113144121

令牌描述可随意填写,权限此处只需要projects权限即可

image-20211102113311403

令牌生成后要妥善保管,后期无法再次显示,一旦遗失则需要重新创建。

image-20211102113521995

2 安装并配置PicGo

PicGo是一款强大的图片上传、管理软件,支持macOS、Windows、Linux跨平台使用。

下载地址:molunerfinn.com/PicGo/

2.1 配置PicGo

PicGo默认不支持Gitee图床,但我们可以通过安装插件的方法使其支持。

进入插件设置,搜索gitee,个人推荐使用gitee-uploader插件,选择安装。

image-20211102113853734

随后在图床设置中选择gitee,进行gitee配置

  • repo:填写仓库地址(如果不知道填什么,进入仓库,url中https://gitee.com/后面跟的地址就是了)
  • branch:分支,我们默认使用master
  • token:这里填写我们在1.2步骤中生产的gitee个人令牌
  • path:图片上传路径,如果创建了路径就在此处填写,不填写默认上传至仓库的根目录

点击确定保存,也可以设置为默认图床。

image-20211102114148422

2.2 上传测试

进入上传区,上传图片测试,成功后会提示上传成功。

进入相册即可看到上传成功的图片。也可以在相册内对图片进行管理。

上传成功后会返回一个上传后的URL到剪贴板,默认选择的是Markdown格式,可直接粘贴到Markdown中。

image-20211102114949685

3 Typora配置

Typora是一款十分优秀的Markdown编辑器,支持实时预览Markdown文档,支持跨平台部署,支持多种皮肤样式,让Markdown编辑更加简单高效。且Typora原生支持集成PicGo。

下载地址:

typora.io/

3.1 集成PicGo

插入图片模式选择上传图片

上传服务设定,上传服务选择为PicGo(app)并将PicGo路径指向PicGo目录中的PicGo.exe文件。

image-20211102120417032

点击验证图片上传选型

image-20211102140522012

打开PicGo的相处,可以看到两张Typora的图片,配置完成。

3.2 使用

在使用Typora编辑Markdown时,需要插入图片时直接将图片文件拖入文档中或粘贴进文档中,图片即可直接上传到图床,并且插入到Markdown文档中。