gitee markdown 笔记_Gitee+PicGo+Pandoc+Typora组建markdown编辑器

cd1971567ef3497efc91c313ccd157ce.png

1 前言

一文多发的时候文章排版就成了一个大问题。经过多种试验对比,最终选择使用Typora编辑器。即使不发文,使用Typora编辑个人日常积累文档写也是极好的。
Typora 是一款Markdown文本编辑器,通过markdown语言可以很容易实现优雅的排版,可以很容易的在源代码和视图模式间切换,真正的所见即所得。
目前一些平台,如CSDN,简书,已经支持markdown语言编辑,是一种标记语言。我们在Typora中编辑完了以后只需要将markdown代码粘贴即可,无需再进行排版。不同网站会根据自己的主题设置将markdown翻译成自己的风格。不过,不同平台一些特殊的markdown标记可能有些许不同,不过一般常用的标记都是通用的,日常的发文够用了。粘完了预览看下,遇到了稍微改下就好,比重新排版强多了。 使用markdown语言编辑文档最大的一个问题就是图片链接问题。markdown代码中不存放图片,是图片地址。文中引用本地图片直接粘贴到网络平台肯定是不行的,是需要重新上传编辑的,太麻烦。使用网络中的图片就可以在本地和网络平台通用。 因此,我们需要把自己的图片上传到网络,拿到图片的地址填写到文中。本文主要介绍的就是如何用最简单的方式实现该功能。同样经过多种试验对比,最终选用gitee+PicGo+pandoc对Typora功能进行扩展实现。
gitee作为图床,存放图片,国内服务,快。 PicGo作为图床管理工具,实现图片上传,图片网络链接获取等功能。 pandoc可以将Typora的markdown文件导出成pdf、docx等格式。该插件对个人发文作用可能不大,但可以很方便的将自己写的文档转存发给别人。

2 软件安装

2.1 安装node.js

该软件在PicGo安装gitee-uploader插件时会用。 一路Next默认安装就好,也可以安装到指定目录。无需勾选安装下图所示的工具。安装工具会从国外的网站下载,速度比较慢。不安装也不影响插件下载,所以就不用装了。 c91dc56780307374388f9397edc644cc.png 安装完成后,在cmd中输入如下图所示的命令查看相关工具是否安装成功。 aa09123e2d4cbe958ea9ab1dc48f68de.png

2.2 安装PicGo

该软件用于管理gitee图床。 一路Next默认安装就好,也可以安装到指定目录。

2.3 安装Typora

该软件用于编辑markdown文件。 一路Next默认安装就好,也可以安装到指定目录。

2.4 安装pandoc

该软件在Typora将markdown文件导出成pdf、docx等格式时使用。 一路Next默认安装就好,也可以安装到指定目录。安装完成后,在cmd中输入如下图所示的命令查看相关工具是否安装成功。 5d1598df90959294dfa06dd2b459c022.png

2.5 安装包下载

以上软件大家可以直接到对应官网上下载最新版本。由于服务器在国外,下载比较慢。嫌慢的,本人下载了一份存在了网盘,可直接使用下面链接下载。
node.js:v12.14.1 pandoc:v2.9.2.1 PicGo:v2.2.2 Typora:v0.9.86 链接: https://pan.baidu.com/s/1DtnAwinZjex1yU79iVzKFA 提取码:x0x9
所有软件安装完后,强烈建议重启下计算机。

3 软件配置

3.1 配置PicGo

3.1.1 下载gitee-uploader插件

PicGo默认不支持gitee图床,可使用如下图所示的方法进行下载。 5bde9bd19d258c283618795387df0afe.png 为了查看方便,可使用下图所示的方法只显示gitee图床。 c00fd9376a2fe73a76ebf306f71ca5da.png

3.1.2 配置gitee仓库信息

在配置gitee仓库前,需要先在gitee上建一个公开的仓库用作图床。进入如下图所示的配置界面。
不是程序员也没有关系,gitee操作界面比较简单,网上搜下基本就可以掌握。
1954af84e7d76b3765f72273c6609465.png
repo:用户名/仓库名字。打开图床仓库,可在地址栏中直接复制。 284c356d3f97f5a9b154230e6bf6d125.png branch:分支名字,直接写master。 token:码云的私人令牌。在码云的个人主页->个人设置->私人令牌中申请。令牌只需要如下图所示权限即可。 f78d4ff5a5f4f533dafb4abdd9898e45.png path:仓库里的文件目录,可不填。 customPath和customURL:git的提交消息,可不填。
使用如上图所示的配置后,每次上传图片后git提交信息形如:
Upload 图片名字 by picGo - 2020-05-27 23:18:28

3.1.3 设置图片上传重命名

因为我们截图命名一般都很随意,很可能有命名冲突导致上传不成功。可使用如下图所示设置对图片进行重命名后上传。 1a1a30989be8a1918b902b1355a654f8.png

3.2 Typora配置

3.2.1 上传服务设置

在偏好设置->图像配置相关内容。本人的配置如下图所示。
插入图片设置看个人喜好,为了避免重复复制的情况,本人未勾选任何动作,全部手动进行。 这两个动作在Typora编辑器右击手动完成也挺方便,还可以避免一些不必要的麻烦。
9a3b49943e3ebba52e69a117452f6510.png 配置完成后,点击“验证图片上传选项”按钮。若配置正确会向gitee仓库中上传Typora的两个icon,并弹出如下图所示的信息。 91211000c00e0d559262ca42db979ad7.png 配置成功后,只要将PicGo在后台运行就行了,每次使用Typora上传图片会自动调用PicGo。

3.2.2 错误排查

若上传失败,可使用如下图所示的方法查看下Server的端口是不是36677,如果不是改下。 6d3ac5bd545402e30f5d2e5e2018f4d4.png 要遇到其他错误,可在如下图所示的地方查看下PicGo的日志,一般都可以发现端倪。 8b38a4331648c8e5fe538a14e6f53f90.png

4 Typora使用

markdown的语法很简单,记不住也没有关系。界面上点点看下,基本就可以找到想要的格式。若找不到,网上搜下就好了。 当文章编辑完了以后,使用“格式->图像->上传所有本地图片”会将本地图片上传到gitee上。上传成功以后,图片的本地url会自动替换成网络url。
实测发现一次行上传所有本地图片有时候会失败 。一篇文章一般也没有多少图,右击一个个的上传就好。为什么?这是别人写的程序有错了也没办法。 其实gitee提供了OpenAPI接口。有兴趣的话,可以自己对着接口写个脚本,将Typora上传服务配置成自定义命令,就可以替代PicGo的功能。有错的话改下,就完全可控了。 ade5bcd30f31633877b243e4dd39169d.png 我是懒得搞了就直接找插件的。会写代码就这点好,别人能写的你也可以,只不过是时间问题。

5 Typora异地同步

Typora只是个本地软件,不支持远程同步。如果多处编辑的话,需要自己通过网络,比如网盘,实现异地同步。
推荐使用gitee实现异地同步。国内的,快。gitee本身是一个代码远程托管平台,支持私有仓库,默认版本控制工具使用的是git。能同步代码就可以同步文档。利用gitee可以很方便的弥补Typora不能多处同步这个缺陷,还可以查看修改记录,不比一些云笔记香么。 不是程序员亦可以学习下,就可以把gitee当成一个有修改记录的网盘。多处同步也无需每次都全新下载,可以在原位置直接更新,这个是网盘比不了的。gitee可以完美的实现文件的版本控制。
如果你担忧有天gitee不能作为图床了,文章中的图片会显示不出来。你可以在存放文章的仓库里添加一个子仓库,这个子仓库就是图床仓库,复用图床仓库做本地备份。子仓库相关git命令可以搜索submodule相关的指令。比如本人图床仓库的名字是img,最终的目录结构如下: 079038c6ebdc0fef02c3eb3845c05b41.png 即使将来有一天gitee的外链失效了,只需要将图片的网络地址换成本地就行了。由于本地图片和网络图片名字相同,只需要使用Ctrl+h将目录换下即可。
https://gitee.com/xxxx/raw/master
换成
../img
这样就文章内的图片就可以使用本地图片显示出来了。 如果觉得每次使用git命令提交太麻烦,可以将其做成脚本包含在库里,每次修改后点下就行了。呐,已经写好放在下面了。
 @echo off:: pull from remote repositorygit pull || GOTO label:: init submodulegit submodule init || GOTO label:: update submodulegit submodule update --remote --recursive || GOTO label:: checkout submodule to master branchgit submodule foreach git checkout master || GOTO label:: show git statusgit status || GOTO label:: add all changinggit add -A || GOTO label:: local commitgit commit -m "upload by bat" || GOTO label:: push to remote repositorygit push || GOTO label:labelpauseexit
END

84f026441351c4da7dfce944ab828b4c.png
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值