本文讲了利用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。
– 同步至其他地方需要先克隆仓库,商业软件一个账号登录搞定。