· 3 分钟

搭建 Markdown 写作环境

用 Typora + PicGo + Gitee 搭一套顺手写作、随写随传图、一篇多发不头疼的 Markdown 写作环境。

搭建Markdown写作环境

应用场景:

  • 利用AI平台写作时,markdown格式文件更利于交互;
  • 一篇文章发布多个平台;
  • 图片随手复制上传,后面只需引用;

为了方便写作,这时候就需要了解这套环境了:Typora+PicGo+Gitee。

  • Typora:它是一款轻便简洁的Markdown编辑器,支持即时渲染技术,即所写立刻所见,少了排版的时间,专注于文章内容的编辑;
  • PicGo:它是一个用于快速上传图片并获取图片 URL 链接的工具,支持多种图库;
  • Gitee:目前中国最大的代码托管的工具,你可以把它当作一个库。

Typora安装

软件下载

软件安装

  1. 打开文件夹内exe文件,双击安装,并选择“为所有用户安装”,记住安装位置;

  2. 安装完,打开软件选择试用。


PicGo安装

这部分总体分为PicGo安装,Node.js环境安装,插件安装。

PicGo软件获取:

PicGo软件安装:

  • 下载好的安装文件,选择安装路径,然后一直点击下一步就可以(强烈建议安装在非系统盘);
  • Windows系统安装好后,会自动在右下角状态栏里。

PicGo插件安装:

在安装插件前,需要安装安装Node.js环境,直接从官网下载,一路点击下一步即可。安装好Node.js环境后,以下介绍目前网上三种安装插件的方法。

  1. 这是最简单的,重启PicGo软件,打开软件插件设置,搜索插件gitee-uploader安装;

  2. PicGo 2.3.1版本或者新的PicGO2.4Beta版本,尝试多遍都不会出现插件查询结果,很大程度是搜索不到的。这里推荐另一种方法:采用npm 本地安装插件然后导入PicGo的做法。第一步打开picgo安装目录,在导航栏上输入CMD调出命令提示符,输入以下代码:

node -v #显示node.js版本
npm -v  #显示npm版本
  1. 如果出现npm不是系统命令的情况,请重新下载安装Node.js环境;

  2. 显示正确的话,进行下一步,找到PicGo的安装路径,输入CMD打开控制台,采用npm命令安装,安装命令为:

 npm install picgo-plugin-gitee-uploader
  1. 在上步插件安装完成后,目录D:\PicGo\node_modules下,会出现一个文件夹node_modules,点开发现里面有了刚安装的插件

  2. 最后打开PicGo,点击插件设置,在右上角有本地安装按钮,找到刚才的node_module文件夹,找到picgo-plugin-gitee-uploader插件导入,然后重启PicGo即可。

  3. 可以通过其他渠道来下载插件: GitHub:https://github.com/PicGo/Awesome-PicGo; Gitee:https://gitee.com/mirrors_PicGo/Awesome-PicGo。

    下载解压到本地文件夹,通过PicGo插件设置界面右上角手动安装插件;

  4. 安装成功后,先放置一边,我们开始下一步。


Gitee搭建

这一步很简单,放在最后,如果前面软件安装不成功,这一步做了也没用。打开码云官网,注册—登录,页面右上角点击加号新建仓库;

新建仓库页面,注意设置成开源;

设置好后,点击右上角个人头像,选设置,再选左边安全设置中的私人令牌;

在私人令牌界面,填写好描述,过期时间选择永不过期,权限可以只点前两项;

点击提交后,记得保存好密钥,后面不好再翻出来了。


密钥配置

打开 PicGo 主界面,图床设置-Gitee 设置:

  • repo:仓库路径。填写 gitee 的 账户名/仓库名
  • branch:分支,这里默认填写 master 即可,(这里是之前创建仓库选择单分支的原因)
  • token:写入前面生成的私人令牌
  • path:路径,仓库创建的文件夹路径,我这里写的是 img,可不填写。
  • customPath:提交消息。在提交到码云后,会显示提交消息,插件默认提交的是 Upload 图片名 by picGo - 时间,一般选择 default
  • customUrl:本地图库,可不填写

打开 Typora 的偏好设置进行设置:

上传区验证上传图片,在相册中能找到说明配置成功啦