使用Typora+MkDocs+Github仓库取代有道云笔记

本文讲了利用Typora+Mkdocs+Github私有仓库替代恼人的有道云笔记的方法。

为什么不使用有道云笔记

你有没有为了有道云笔记的存储空间而努力签到过？在有道云笔记中，免费用户拥有3GB初始存储空间，每日签到可以获取额外的空间奖励。

但是，这个存储空间的定义是非常模糊的，它并不代表你可以自由使用这些空间。例如，编辑MarkDown文件时，插入图片会有如下提示：

同时，有道云笔记的MarkDown编辑器功能并不完善，编辑长文本时卡顿、吃字就不说了，同步预览不刷新、渲染格式错误等是真的恼人。

作为一个穷人，我并不想给功能缺失的有道云笔记充钱。不充钱的话，也用不了MrakDown的图片插入功能，那就只能say bye bye 了。印象笔记也好不到哪去，因为商业软件有一个共通的缺点：资料不可作为通用格式导出，只能在我的产品中使用。

软件准备

使用Typora+Mkdocs可以组成一个完整的MarkdDown预览与编辑工具，而Github开放了免费的私有仓库，可以作为多端同步之用。

安装MkDocs

我推荐安装chocolatey,chocolatey是一个windows上的包管理器，类似于ubuntu的apt，centos的yum。chocolatey的安装非常简单，管理员运行cmd，一行代码：

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

而后，使用chocolatey安装MkDocs：

choco install mkdocs

安装Typora

Typora是一款优美的MarkDown文档编辑器，使用起来比VSCode要强不少。
访问 https://www.typora.io/ 下载安装包，之后安装即可。

开始使用

1.初始化一个MkDocs文档集

进入你要存档文档的目录，执行如下命令：

mkdocs new MyNotebook

该命令会在该目录下生成一个叫做MyNotebook的文件夹，里面包含mkdocs.yml文件与docs文件夹。

MkDocs可以将文档转换成html，mkdocs.yml是mkdocs编译时所需的配置文件，包含目录结构、主题名等配置字段。个人笔记不用编译成静态博客，可以不用管它。

2.Typora打开文件夹

打开Typora，菜单中选择文件->打开文件夹，之后选择刚刚创建的文件夹即可。

如果左栏中没有出现文件夹层级树，可以选择视图->文件树视图，此时界面显示如下：

左栏目录结构处，可以直接管理文件或文件夹，或者打开已经存在的文件。

3.编辑文本，插入图片

在Typora左栏中新建一个文件夹用来存放图片，命名为images。

• 所需的图片为文件模式，直接拖入该文件夹，使用相对路径引入到文档：

    ![image](./images/test.jpg)

• 使用截图工具截取图片，在预览模式下直接粘贴。粘贴后，Typora提示复制图片到……，点选上文中的images文件夹，Typora会自动复制文件并插入路径。

4.上传GitHub私人仓库

通过sourcetree或其他git软件，将本地目录上传到私有仓库即可。

与有道笔记相比的优缺点

优点：
– 数据可控，可转移，随便用户怎么处理，本质上都是md文件。
– 可Build成静态博客。
– 资料寿命长，不会因为软件挂了而导致一堆私有格式文件打不开。
– 全部免费!不用冲会员就能在MarkDown文件中插入图片。
缺点：
– 修改需要手动提交到Github。
– 同步至其他地方需要先克隆仓库，商业软件一个账号登录搞定。