|
本文微信地址：https://mp.weixin.qq.com/s/1Cl86o2nix8mb_msue0HPA 一、为啥要挑选自建私有云笔记？
私有云笔记有很多，老牌的如：印象笔记、有道云笔记，新兴的如notion、wolai、语雀，跨界的如Teambition、飞书，这些云笔记各有各的特点，也有很多设想上的独到之处，值得称赞。
可是，对于持久利用私有云笔记的用户来说，都有一个没法磨灭的痛点：数据不成控。我们一切的数据都是存储在运营商办事器上的，虽然一些厂商供给了批量导出的功用，可是导出的数据要末是私有格式不兼容其他云笔记产物，要末是word或pdf格式，导出后的排版发生了天翻地覆的变化。
对于印象笔记、有道云笔记、飞书、Teambition和语雀我都有持久的利用经历，这些产物都存在这个题目，虽然他们都是老牌劲旅大概新兴霸主，可是一切的产物都有生命周期，我不希望某一天某个产物不保护了，我的数据也没法导出大概方便地转移到其他产物上去。
是以，我一向在摸索自建私有云笔记。
我尝试过自建leanote（蚂蚁笔记）、群晖note station，可是结果都差强人意，不是自己的编辑才能太弱，就是对markdown支持欠好，还是达不到我的要求。
我一向很喜好markdown的写作气概，市道上也有很多开源或免费的markdown编辑器，那末，我们可不成能利用markdown为根本构建一套私有云笔记系统呢？
答案是必定的，本文我将给出具体的搭建计划和利用技能。
本文将操纵typora + pandoc + 网盘 搭建一套私有化的云笔记系统，它将实现：
- 操纵typora实现完善的markdown编辑衬着
- 操纵typora的图片设备，实现插入图片当地化存储
- 操纵typora+pandoc实现多种格式输出
- 操纵typora的文件夹导航功用实现笔记的树状层级显现
- 操纵typora的查找搜索功用实现精准的全文检索
- 操纵markdown的相对途径链接实现文档间的援用链接
- 操纵网盘的同步功用实现多端同步同享
这套系统虽然还有一些功用今朝没法实现，比如双向链接，比如网页剪藏，可是它已经是一套很是适用的笔记系统了。
这里我想提高一下我的笔记理念：笔记的重点在于随手记录，记录自己的想法和参考援用链接，而不是搬运书籍大概网页上的内容。是以，我不是很赞成用网页剪藏的方式大段搬运互联网上的内容，没成心义，搬运完了能够就永久存在那边，你永久不会看，大师想想自己在印象笔记大概有道云笔记里剪藏的那些文章，有几篇是频频精读的？
二、安装用到的软件工具
搭建私有云笔记所需要的软件工具：
- pandoc：
- 从官网下载安装即可：https://www.pandoc.org/installing.html
- typora：
- 从官网下载安装即可：https://www.typora.io/
- 网盘：保举百度网盘或自建NAS的同步软件（如群晖Drive或威联通Qsync）
- 比来百度网盘全线更新了同步空间的功用，就是跟群晖Drive大概威联通Qsync的功用一样，实现多真个文件同步。
三、typora的设置和利用
1、设置插入图像时的存储位置
利用过markdown写文档的人都晓得，markdown有一个很是不方便的地方，就是插入图片时，图片没法同内容存储到同一个文件内，现实上，.md文件本质上只是一个文本文件，存储了文本内容以及格式标识符，由markdown编辑器或衬着器读取源文件后衬着成都雅的格式。
由于这个特征，致使我们在插入图片时，要末利用在线图床（需要找图床大概自己保护图床，也很麻烦），要末需要吃力保护本舆图片的存储位置。即使是一些支持了markdown图床的私有云笔记，在导出markdown格式文档时，图片也没法导出，只能经过Internet URL的方式援用，在我们停止离线检察大概备份时很是不方便。
typora为我们处理了这个题目，我们可以依照以下的法则设备typora，使得我们插入的图片城市复制到当地的assets目录下，并依照文件名建立目录存储，这样假如我们想将一篇文章拷贝走，只需要拷贝这篇文章的源码.md文件，以及源码目录下的assets/filename目录即可。
途径诠释：
./assets/${filename}
这是一个相对途径，暗示在当地目录下的assets目录下（如无则自动新建），以该文件名为称号建立一个目录，寄存插入到该文件内的一切图像。
留意，我们也倡议对本舆图片和收集图片都利用上述法则，并设备优先利用相对途径，这样方便文档的整体迁移。特别是针对收集图片，你也没法保证该图片链接何时生效，存到当地是最保险的。我之前就有很多文档的图片利用了公共图床大概间接援用了收集位置，由于收集位置生效而丧失图片，所以要引以为戒，数据一定要可控。
2、导出设备
我们在利用markdown写作时，偶然也会不成避免地需要将markdown导出为其他格式，私有云笔记很多时辰导出的格式有限，甚至导出后整体排版城市发生变化，丑陋变形。那末我们自己搭建私有云笔记时，应当怎样才能处理这个题目呢？
别急，typora帮你想到了。
typora操纵pandoc可以实现多文本导出，而且导出格式很是完善。
pandoc是一个说明的格式转换工具，好用还免费。我们依照前面的教程安装好pandoc后，仅需要在typora中设备好pandoc的途径便可以利用pandoc的强大功用了，以下图所示：
Tips：Windows下可以利用everything搜索pandoc的安装目录，Linux或Macos下可以利用which或whereis号令检察pandoc号令地点途径。
参考阅读：https://support.typora.io/Install-and-Use-Pandoc/
3、利用技能
做完前面的预备工作后，我们便可以起头我们愉快的笔记之旅了。
这里我利用的是百度同步空间，我在百度同步空间的文件夹下新建了一个“进修笔记”文件夹，在里面新建.md文件，一个.md文件就是一篇笔记，还可以用文件夹将笔记分门别类，就像有道云笔记里的文件夹，印象笔记里的笔记本，相比它们的优点是：我可以无穷层级嵌套下去。
以下所示，是我的笔记结构，我一般习惯在最外层建立一个index.md目录索引文件：
Tips：若何新建.md文件？新建一个txt文件，然后重命名为"xxxx.md"即可，留意要点窜后缀名为".md"
双击index.md后，会挪用typora翻开（条件是你电脑设备了.md文件的默许翻开法式是typora，一般typora安装后城市默许设备，假如没有设备，请“挑选.md文件右键---翻开方式”手动设备）。
翻开.md文件后，默许是不显现边栏的，可是边栏实在是一件很有用的东东，我们这内行动开启：
开启边栏后，我们就会看到边栏供给了文件和纲领两种视图，可以手动切换，其中文件视图下，可以经过右下角的按钮切换列表视图或树视图。在文件视图下，看到的是当前文档地点目录下的目录结构：
在纲领视图下，我们看到的是当前文档的目录：
我们可以在一个文档里经过markdown相对位置援用链接指向另一个文档，实现一键跳转：
Tips：我们倡议在笔记根目录下实现一个index.md作为全部笔记的目录索引，这样方便我们翻开笔记并快速定位到相关内容。
在侧边栏里，我们可以利用typora的查找功用实现当前目录下（包括子目录）一切文档的全文检索：
四、markdown常用语法
我们这套笔记系统，利用的是markdown语法停止誊写。markdown语法很简单，也很强大，可以排版，可以做表格，可以绘图，可以写代码，还能写数据公式，你能想到的它都能干。
固然，markdown本质上是一套语法标准，分歧的markdown编辑器对标准语法的兼容能够分歧，我们给出typora下常用的一些誊写方式，更多typora支持的markdown语法可以在typora菜单栏：帮助中找到，这里还有一些其他帮助，可供参考：
typora下markdown誊写示例：
# 一级题目
## 二级题目
### 三级题目
#### 四级题目
**有序列表：**
1. 有序列表第一行
2. 有序列表第二行
3. 有序列表第三行
**无序列表：**
- 无序列表第一行
- 无序列表第二行
- 无序列表第三行
**行内代码：**`var a = 123`
**行外代码块：**
```python
print("hello world, this is a python code")
```
**插入链接：**
[这是一个百度链接](www.baidu.com)
小技能：间接复制URL，粘贴到typora中即可
提醒：这里可以利用URL，也可以利用当地途径；当地途径可以利用绝对途径或相对途径，我们在构建目录时，就是利用当地相对途径指向其他文档。
**插入图片：**间接复制图片，粘贴到typora中即可
<font color='red'>红色字体</font>
显现结果：
这里请留意“红色字体”的输入方式，实在typora是支持html说话的，我们可以经过嵌入html语句间接改变笔墨的显现方式，这里的<font>元素的用法只是凤毛一角，假如需要显现更复杂的字体结果，还可以利用html元素的style属性界说，例如：
Tips：这里常用的元素有：<p>、<div>、<span>等，更多关于html块级元素和内联元素的内容参考：https://www.w3school.com.cn/html/html_blocks.asp
|
