夜法之书 • Posts by &#34;note&#34; category

[十万字图文教程]基于Hexo的matery主题搭建博客并深度优化完全一站式教程

markdown 各种其它语法插件，latex公式支持，mermaid图表，plant uml图表，URL卡片，bilibili卡片，github卡片，豆瓣卡片，插入音乐和视频，插入脑图，插入PDF，嵌入iframe

Joplin 插件以及其Markdown语法。All in One!

2021-09-09T14:25:00.000Z

Joplin是一个以Markdown为主要语法的笔记程序，发展到今天增加了许多插件，这些插件也大大增强了它的功能，今天我们就讲讲Joplin的各个插件的作用和使用方法。

首先我们打开Joplin，依次点击工具->选项设置页面，然后点击Markdown选项卡，我们就可以看到如下界面

下面我们一个一个讲解一下每个插件的大概作用和用法，某些插件的详细使用方法可能需要我独立写一篇文章来介绍，这里我就先抛砖引玉大致介绍一下。

启动软中断插件

Joplin默认使用的是硬中断方式，那么什么是软中断什么是硬中断呢？如果你刚开始使用Markdown撰写自己的笔记你可能会非常的不习惯，因为标准的Markdown语法里面换行需要两个回车符号，但是像word之类的编辑器都是一个回车，普通人会感觉很不习惯，所以Joplin默认采用了硬中断方式，这样你可以使用一个回车符实现换行。但是当我们启用软中断插件之后，我们就需要两个回车符来实现换行（准确说应该是分段），使用两个空格加一个回车来实现换行，前者的间距会比后者的大。启用软中断其实对于普通人来说不是很好用，很难适应，所以我不建议大家开启该插件！

启用typographer支持

我们启用插件之后，在我们想要声明著作权的地方键入：

(c)著作权所有人

然后Joplin就会给我们渲染为：

是不是很熟悉，很多网页的底部都会有这个声明！

启用数学表达式

这个是Markdown自带语法，Joplin使用插件来实现的，其实就是大家在Markdown语法里面看到的行内公式使用 $\dots$ ，行间公式使用$$…$$。需要说明的是Joplin使用的是Katex来解析数学符号，它的语法和Latex的数学公式写法差不多，我到现在还没有碰到很大的不同的地方！

启用高亮`==Mark==`句法

这个其实就是一个语句高亮插件，中间的语句会被高亮显示，有助于我们对重要的内容进行强调，自己一试就一目了然了。

启用脚注

脚注的功能就是对文中的某一个特定的术语等进行解释补充说明，有点像是论文的参考文献，下面是一个简单的示例，相信大家一看就懂

根据图片你可能明白了脚注的使用方法：在我们想要使用脚注的地方使用[^唯一标识符]注明，然后在文章的最后使用响应的标识符进行说明即可，比如例子中的

[^lightzhan]:知乎搜索light zhan即可找到我了

注意那个冒号一定要是英文冒号，中文冒号可能无法被成功解析。

启用目录扩展

启用该扩展，我们就可以使用相应的语法在某个位置插入我们文章的目录，具体的语法为

[toc]

注意着是一个固定的符号，不需要改变什么，只需要在我们想要插入目录的地方放上**[toc]**即可，例如

上图最重要的就是坐上脚的[toc]指令，该指令自动生成了右边的整个目录！

启用下标`~sub~`和上标`^sup^`句法

一看到_sub如果不小心就会认为这个是删除线，大错特错了，一定要明白两者的区别，删除线是左右都是两个波浪线，而这个只有一个波浪线，一定要搞清楚这个。下面我们看看这个插件的作用和用法。

这两个插件的作用其实很简单，就是下标和上标，看例子应该就明白的

启用术语表插件

对于这个插件得先知道什么是术语表。所谓的术语表其实可以理解为一个定义的列表，很多专业的书籍的前面都会有术语表，因为它需要给出书中所用术语的定义和解释。还不懂？我们在Joplin中启用该插件，然后新建一个笔记，输入如下文字：

Qdown

:   Qdown是由lightzhan开发的全功能软件下载程序，这里是程序的介绍页哦:http://lightzhan.xyz/index.php/qdown/ 

LightZhan

:   计算机爱好一名，爱折腾哎生活，*欢迎知乎关注lightzhan哦*

        可以嵌入一些代码

    定义第三段

这些文字会被解析显示为：

对比一下发现了什么没有？术语表的每一项由两个部分组成，第一部分是术语，第二部分是该术语的解释，多个术语及其解释组合在一起就组成了表，这就是术语表！需要特别注意的是术语表的书写格式是固定的，如果你想要快速上手，建议你拷贝上面我提供的示例进行修改，修改两下你就懂格式到底是怎么回事了！

启用缩写句法

这个插件很有意思，也很有用。你是否记得有些程序的按钮，当你把鼠标放上去的时候它会显示按钮的作用。不记得了？不存在，我们也使用例子来说明。下面我们启用缩写句法插件，然后新建笔记，在笔记里面输入：

*[Qdown]: 由lightzhan开发
*[LightZhan]:  欢迎知乎关注我哦
Qdown 是由 LightZhan 开发的一款全协议下载器.

该文本会被Joplin显示为

这可能并不能完全显示出该插件的作用，因为截图的原因截不到，当我们把鼠标放在Qdown上面的时候，鼠标所在的位置处会弹出“由lightzhan”开发的提示。不理解的可以拷贝上面的代码到Joplin感受一下，记得要开启该插件哦！需要注意的是该句中对应的缩写词前后都要有空格，负责你可能看不到上面的效果。

启用Markdown emoji

该插件是用于在我们的笔记中插入表情的，这是一个简单的示例截图

详细的表情和表情的代码，可以参考这里。

启用`++insert++`句法

这个插件很好理解，一试便知道作用和用法了

说了那么多，就是在对应的文字下面显示一个下划线！

Markdown是非常好用的笔记书写规范，记着，Markdown不是某一个软件，而是一个通用的笔记书写规范，通过使用该规范进行写作，解析器会按照规定的样式将其渲染显示出来，说得直白点就是用于文字排版的。

Markdown的排版语法

这里的讲解如果有不懂的可以参见下一节的示例：

标题。markdown的标题使用“#”符号开头，一级标题一个”#”，二级标题两个“#”（也就是“##”），以此类推三级标题四级标题…….，不同级的标题会被渲染为不同的大小和样式（根据各个软件和相应的主题而定）；
粗体。markdown的粗体字使用两个“**”包裹即可，比如 “你好”解析后变为“你好”；
斜体。markdown的斜体使用“*”或者“_”包裹，比如“你好”解析显示为“你好”；
引用。markdown的引用使用“>”开头，大部分软件要求“>”要和引用内容之间有一个空格；
代码。对于程序员来说可能想要在文中插入代码，markdown是支持插入代码的，行间代码使用一个"`"符号包裹，注意这个符号是键盘左上角Esc下面的那个键，不是我们所谓的英文上一撇；
数学公式。markdown的数学解析一般使用latex语法，行内公式使用一个$包裹即可，行间公式使用两个$包裹；
markdown的列表分为有序列表和无序列表。有序列表就是有序号，无序列表就是无序号，有序列表就是在数字后面一个点，然后空一格写正文，比如：1. xxxxxxx，第二点需要新起一行2. xxxxxx。无序列表是使用“*”或者“-”开始，后面跟一个空格写上正文。
markdown的勾选框。markdown的勾选框使用- [ ]，注意字符之间都是有空格的。比如：第一行- [ ] A,第二行- [ ] B。这样对应的渲染结果就是勾选框和对应的选项。注意字符之间的空格！
表格。markdown的表格非常易于理解，请看下面的示例。

示例代码和渲染结果

下面的示例左边是书写文字，右边是渲染结果，注意书写文字里面的标识符和内容之间的空格：

需要说明的是上面的粗体显示为了橘红色的字体，这是我自己设置的格式，这个等大家熟悉了后可以使用CSS设计自己喜欢的样式。下面是表格的渲染结果（其中左边的源代码不用那样对齐，横线的个数一处最少3个就行，右边是解析后的显示结果）：

额~，左边左下角那个是鼠标光标，不是文字内容哈。需要说明的是不同的软件的不同的主题可能显示的结果会不一样，但是书写的语法是不变的。

启用 multimarkdown 表格扩展

这个插件说高深也不高深，看名字应该就能知道这是一个增强Markdown表格功能的插件，大家记得Markdown的表格是怎么使用的吗？如果忘记的话赶紧看看这篇文章回顾一下，不然下面的内容可能体会不会那么深！

好啦，我这里假设读者知道markdown的表格是怎么用的，然后我们开始讲解multimarkdown扩展。Markdown自带的表格功能是非常有限的，如果你使用过的话就会发现它能做出来的表格一定是规整的，行和列一定是划分均匀整齐的，但是有时候我们需要的表格可能是这样的：

这种表格使用Markdown的表格是不可能做出来的，因为分组的效果和占用两个格子的效果是做不出来的，但是如果你启用了MultiMarkdown插件，你就可以使用下面的代码渲染出来：

|             |          分组                 ||
第一个表头     | 第二个表头     | 第三个表头      |
 ------------ | :-----------: | -----------:   |
内容          |          占用两个格子           ||
内容          |   **内容**     |         内容    |
新的一部分     |     更多       |         更多    |
更多          | 带有一个跳过的 '\|'              ||
[LightZhan制作]

你可以把上面的代码拷贝进Joplin编辑器研究一番就能理解MultiMardown表格扩展的用法了，下面我详细讲解一下。

MultiMarkdown的表格扩展支持下面的功能：

使得元素占据多个列（上面的示例中有）
使得元素占据多个行
在表格上面或者下面对表头进行分组（上面的例子中有）
在表格的上面或者下面标注表格标题（上面的例子中有）
在表格中包含分块元素（列表、代码、段落等等）
表格不需要表头

上面标注了“上面的例子中有”的我这里就不在讲了，因为代码一研究或者修改修改就知道咋回事的，下面我们主要讲讲上面的例子中没有涉及到的。

1.使得表格占据多行。这个其实很好用，但是有两种情况。第一种情况是一个项目占据两格。这种情况要占据多行的话，在我们对应列的起始行写上内容，然后接下来要合并的行直接写“^^”。不明白不存在，我们来一个例子：

上面对应的代码是什么呢？看下面：

作者		| 信息			  | 信息		 |
----:		| --------------:         | ---------:	         |
LightZhan	| ligthzhan.xyz 				||
^^		| 更多Joplin教程           | Qdown下载器	         |
[LightZhan制作，允许规范转载]

把上面的代码拷贝进编辑器改改试试，很容易明白里面的玄机的！

第二种情况是我们添加块，看下面一点。

2.**在表格中添加块元素。**这个不用多说，直接在表格的格子里面用Markdown语法写作，渲染成对应的Markdown格式！比如加粗、斜体、代码块等等。下面来一个简单的例子，需要注意的是下面的例子当中我们的内容有几行！

|   Markdown   | 渲染结果       |
|--------------|---------------|
|    *斜体*    | *斜体*         | \
|              |               |
|    - 项目1   | - 项目1        | \
|    - 项目2   | - 项目2        |
|    ```python | ```python       \
|    .1 + .2   | .1 + .2         \
|    ```       | ```           |
[LightZhan制作，允许规范转载]

注意代码后面的”\”，这个符号是指定换行的，如果项目占据多行一定要写上。上面的代码复制黏贴进编辑器可以看到下面的渲染结果

**3.表格不需要表头。**这个也很简单，直接不写表头即可。拷贝下面的代码进编辑器

----:		| --------------: | ---------:	 |
LightZhan	| lightzhan.xyz 	        ||
^^		| 更多Joplin教程  | Qdown下载器	 |
[LightZhan制作，允许规范转载]

然后你就可以看到惊喜

启用Fountain语法支持

这个插件的目标人群非常少，Fountain语法是用来写电影剧本的，而且要是要细讲的话估计又是一篇文章，因为使用的人非常少，所以我这里就不讲这个了。

Mermaid插件的作用

Mermaid是一个用于画流程图、时序图、类图、状态图、甘特图、饼图的Markdown扩展，其中状态图是最新8.4版本的新功能。如果你不知道这些图是干什么的，不存在，下面的教程里面我会每个都给出例子。

在Joplin里面使用Mermaid

在Joplin里面如果想要使用Mermaid，那么你需要使用代码块，并且代码的类型填写mermaid，详细的格式如下：

```mermaid
graph TD
    Start --> Stop
```

在渲染区我们就能得到如下的结果

Mermaid流程图

下面我们讲解在Mermaid里面画流程图。上一节的示例便是流程图，我们把上一节的代码拿出来分析一下。首先我们看代码的第一行：graph TD，这一行代码有两个作用，graph表示我们图的类型，graph表示流程图，而第二个TD表示图的方向，可能的方向有如下几个

TB：自顶向下
BT：自底向上
RL：从右到左
LR：从左到右
TD：和TB一样

上面我们的例子使用的是TD，如果你对其它的方向不明白，可以把代码拷贝到编辑器里面修改方向参数就可以理解各个方向的意义了。

上面的代码非常基础，因为如果要实现比较复杂的流程图，我们就需要使用一些比较高级的语法，比如定义节点。所谓的节点，你可以简单的理解为上面图片中的方框，但是如果我们要使用其它形状的节点怎么办呢？在上面的例子中我使用了默认的节点定义方法，也就是直接使用文本,这种方式定义节点的话id和显示文本是一样的，而且形状是固定的矩形。如果要定义不同的节点形状，或者使得id和显示文本不一样，可以使用下面的语法

定义矩形形状的节点：id[text]
定义圆角矩形的节点：id(text)
定义椭圆形的节点：id([text])
定义圆柱形的节点：id[(text)]
定义圆形的节点：id((text))
定义非对称图形的节点：id>text]
定义菱形的节点：id
定义六角形的节点：id
定义平行四边形的节点(两个方向)：id[/text/]或者[\text]
定义梯形的节点(两个方向)：id[/text] 或者 di[\text/]

注意上面的id和text是需要我们自己定义替换的，如果同一个id有多个text，取最后一次的定义值！

有了节点我们还需要将节点连接起来，也就是我们要使用线条或者箭头来进行节点的连接，Mermaid支持下面的方式：

实线箭头：A–>B
实线无箭头：A–B
无箭头实线上带文本：A–text–B
实线箭头带文本：A–>|text|B 或者 A–text–>B
虚线箭头：A-.->B
虚线箭头带文本：A-.text.->B
粗线箭头：A==>B
粗线箭头带箭头：Atext>B

最好的办法就是把上面的代码拷贝进编辑器看看，一看你应该就能理解各个图形的形状！

上面我们讲解了节点和连线，下面我们说说图形的绘制。上面我使用的例子非常基础，下面来一个复杂点的例子供大家修改和研究

```mermaid
graph TD
    light[LightZhan]
    url[lightzhan.xyz]
    QdownUrl[访问LightZhan博客Qdown页面]
    Qdown((Qdown))
    function[功能]
    Qdown-->|作者|light 
    light--个人主页-->url
    Qdown-->function
    Qdown-->QdownUrl
    function1[极速下载]
    function2[磁链/BT下载]
    function3[迅雷下载]
    function5[下载体验]
    function4[Http/Https/FTP/SFTP]
    function-.功能1.->function1
    function-.功能2.->function2
    function-.功能3.->function3
    function-.功能4.->function4
    function-.更多功能.->function5
    annocement[本文首发于lightzhan.xyz,允许规范转载]

```

上面代码的渲染结果如下：

如果不清楚，可以把上面的代码拷贝到编辑器进行修改和摸索！

Mermaid时序图

时序图是用于展示过程的方式和顺序的。举例来说，两个人之间的对话:

A先问B：Qdown是啥？B回答：Qdown是全功能的下载软件！A又问：哪里可以下载呀？B回答： http://lightzhan.xyz/index.php/qdown/ 。我们使用mermaid绘制时序图来展示上面的对话过程：

这样是不是看上去清晰了很多了呢？希望通过这个例子能让你深切地感受到时序图是干什么用的！好了，放上上面的时序图的代码供大家研究：

```mermaid
sequenceDiagram
A->>B:Qdown是啥？
B-->>A:Qdown是全功能的下载软件！
A->>B:哪里可以下载呀？
B-->>A:http://lightzhan.xyz/index.php/qdown/
```

让我们来简单分析一下上面的代码。你可能注意到了第一行的sequenceDiagram，这个就是告诉mermaid我们在这里绘制时序图，然后下面有箭头，在时序图里面，mermaid支持下面类型的箭头和线段：

实线并且没有箭头：A->B:text
虚线没有箭头：A–>B:text
实线带箭头：A->>B:text
虚线带箭头：A–>>B:text
实线并且在终点带一个x：A-xB:text
虚线并且在终点带一个x：A–xB:text

上面的text就是要显示在箭头或线段上的文本，在mermaid的时序图里面被称为消息，线段或箭头类型如果有不清楚的可以拷贝到编辑器里面看看，一目了然！

还记得上面我们在流程图里面的节点吗？在时序图里面不是定义节点，而是定义参与者，也就是上面的A和B。上面的代码中我们定义参与者的方式采用的是默认方式，也就是不显示定义，有时候我们的参与者的名字太长的话可以使用显示定义来定义别名：

participant John
participant Alice
participant A as Alice
participant J as John

上面代码的第一二行仅仅是显式定义我们的参与者，第三四行给我们的参与者定义别名，定义了别名后我们在下面的使用中就可以直接使用A代替Alice，使用J代替John了，这样输入会方便很多！

好了，时序图差不多就讲到这里，接下来的一些高级用法大部分我们都用不到，或者要使用的话不如使用专业的绘图软件使用插图的方式导入。

使用Mermaid绘制类图

类的定义

在讲解如何绘制类图之前我们先了解一下什么是类图！如果你是计算机专业或者会计算机编程的话应该就懂面向对象编程，对象是类的实例，而这里要绘制的类图就和面向对象编程里面的类相关。

对于编程人员来说，函数具有参数和返回值，属性具有变量类型，我们举一个例子来说一下：

class BankAccount{
  +String owner
  +BigDecimal balance
  +deposit(amount) bool
  +withdrawl(amount)
}

上面的代码的渲染结果为：

上面的代码是我直接从官方借鉴的，可以直观地看出对于银行账户（BankAccount），一共有两个属性和两个方法，属性都是具有对应的变量类型，而对于函数具有参数（amount），并且deposit函数还具有bool类型的返回值。你或许看到了前面的+号，这个是对应变量或属性的可见性，分别有：

+ public
– private
# protected
~ Package/Internal

如果我们想要定义的函数是抽象函数咋办呢？在括号的后面添加*即可：

someAbstractMethod()*

在渲染过后抽象函数会使用斜体进行显示，这里就不截图展示了。对于静态函数，将后面的*换为$即可，在显示时静态函数会具有下划线。

类之间的关系

在编程中我们常常会用到的关系：

<\|–	继承（Inheritance）
*–	组成（Composition）
o–	聚集（Aggregation）
–>	关联（Association）
—	实线（Link (Solid)）
…>	依赖（Dependency）
…\|>	实现（Realization）
…	虚线（Link (Dashed)）

下面我们举一个例子：“狗”继承自“动物”类别

```mermaid
classDiagram
    class 动物{
        特点1：能动
        特点2：能叫
    }
    class 狗{
        特点1：4条腿
        特点2：会汪汪叫
        特点3：可爱至极
        汪汪叫(陌生人)
    }
    动物 <|-- 狗
```

渲染结果为：

结合代码和展示结果应该很好理解，这就是一个狗继承自动物的简单例子，我们还可以对关系结果打标签：

```mermaid
classDiagram
    class 动物{
        特点1：能动
        特点2：能叫
    }
    class 狗{
        特点1：4条腿
        特点2：会汪汪叫
        特点3：可爱至极
        汪汪叫(陌生人)
    }
    动物 <|-- 狗:属于（继承）
```

我们在关系指示后面加上冒号，然后后面加上关系说明，这样在渲染结果当中我们就可以看到箭头上出现了我们需要的标签说明：

好了，使用mermaid绘制类图就讲到这里，还有一些用法不是很常用，我就不讲了。

使用mermaid绘制饼图

绘制饼图的需求比较多，很多数据展示需要我们绘制饼图，幸运的是mermaid给我们提供了绘制饼图的功能，使用方法极其简单：

```mermaid
pie
    title LightZhan创作，允许规范转载（http://lightzhan.xyz）
    "Joplin" : 42.96
    "Qdown" : 50.05
    " 黑科技" : 10.01
    "其它" :  5

```

在上面的代码中，pie关键字指定我们要绘制饼图，然后tiltile指定我们的标题，后面是数据分布，注意，mermaid会将我们输入的数据进行计算，上面的数据加起来并不是100，所以我们看到在下面的渲染结果中数据对应不上。

Joplin插件非常丰富，你能找到各种各样的功能，这里推荐一些插件使用，见下面这篇文章， Joplin插件推荐。

参考：

lightzhan.xyz

系列教程

笔记系列

Gitbook使用系列

Gitlab 使用系列

Hexo系列

[十万字图文教程]基于Hexo的matery主题搭建博客并深度优化完全一站式教程

markdown 各种其它语法插件，latex公式支持，mermaid图表，plant uml图表，URL卡片，bilibili卡片，github卡片，豆瓣卡片，插入音乐和视频，插入脑图，插入PDF，嵌入iframe

替代Evernote免费开源笔记Joplin-网盘同步笔记历史版本Markdown可视化

2021-09-09T13:25:00.000Z

Evernote笔记是我们常用的一个笔记服务，国内叫印象笔记，免费版本的Evernote笔记其实已经足够我们使用了，但是对于重度的笔记用户，Evernote某些功能可能需要付费升级才可以使用，而且你的笔记是存放在Evernote的服务器上。

有些同学可能觉得放在Evernote服务器上的笔记会不安全，况且有些隐私性很强的笔记确实不适合放在公共的服务器上。此时，你需要一个可以保护个人隐私同时还可以与Evernote笔记功能相媲美的免费笔记服务：Joplin，它是一款免费开源的笔记软件。

Joplin跨平台支持，包括PC桌面端，移动端，甚至提供了命令行版本，原生支持 markdown 格式，搜索速度快，可以通过其他第三方同步工具 (Dropbox/NextCloud/OneDrive/WebDAV/etc) 进行备份以及同步，支持浏览器Web clipper即网页剪贴。

Evernote笔记该有的功能Joplin都有了，如果你不想掏钱购买Evernote付费版本，Joplin将是最佳的替代品。更多的自建服务还有：

PS：更新记录

1、平时经常要校对文本，以及有大量的文件需要在电脑和移动硬盘同步，可以试试这些免费的同步对比工具：八大免费的文件对比同步工具-免费文件对比分析与复制同步备份软件。2021.3.24

2、对于1Password这类的密码管理软件重度依赖，但是苦于囊中羞涩的话，不防自建密码管理平台：Bitwarden自建密码存储系统图文教程-开源免费的bitwarden_rs安装与使用。2020.10.10

一、Joplin安装和使用

网站：

https://joplinapp.org/

直接到官网下载Joplin安装包，安装好了就可以启动Joplin了，以下是Joplin的软件界面，分成三栏，和我们平时熟悉的笔记软件是一样的。（点击放大）

这是Joplin的编辑器，支持 MarkDown，图片、数学公式、复选框等 MarkDown 语法。

不习惯MarkDown，直接切换为可视编辑即可。

在Joplin的设置选项中还提供了非常多的MarkDown的插件，对于MarkDown深度用户来是一个福音。

二、Joplin的特色功能

2.1 笔记历史版本

Joplin提供了笔记历史版本，让你轻松地恢复任意时间的笔记版本。在“工具” > “选项” > “笔记历史”中启用，以及设置保留的笔记历史天数。要查看笔记的历史版本，点击编辑器上方的笔记属性图标，然后选择恢复：

2.2 E2EE安全加密

在同步过程中，笔记本、笔记、标签等均以纯文本文件的方式同步，如果你还觉得不安全，你可以开启端到端加密（E2EE），把文件加密后同步到云端。由于 Joplin 的去中心化，密码必须手动在每个终端设置。

**注意：不要在多个设备上同时启用加密，否则可能会造成加密密钥问题。特别提醒：**加密之前，先将笔记导出JEX备份一份，以防万一。

2.3 Joplin手机APP

Joplin可以直接在各大应用市场上下载，使用起来也很方便。

2.4 外部编辑器

Joplin自带的编辑已经非常强大的，如果你想要使用自己的编辑器来编辑笔记也是可以的，包括文本编辑器（如 Notepad++）、 Markdown 编辑器（如 Typora）等。

通过 Ctrl+E，或 Joplin 编辑器上方的图标（如下图）从外部编辑器打开笔记，从外部编辑器打开后，Joplin 将持续监控该文件，当你从外部编辑机保存后，Joplin 将自动同步最新变动。

你可以在“工具” > “选项” > “通用选项”中指定编辑器的路径。

三、Joplin同步与备份

Joplin与其它的笔记软件很大的不同就是没有存储功能，你需要将Joplin的笔记放在自己的主机或者网盘里，幸运的是Joplin支持多种方式的云同步：Nextcloud / Dropbox / OneDrive / File system / WebDAV。

3.1 Joplin免费网盘同步

目前，Joplin支持Dropbox 、OneDrive 网盘同步，在同步选项中选择OneDrive，然后就会打开认证。

同意验证。

与 OneDrive 同步时，Joplin 会在 OneDrive 中创建一个子目录：/Apps/Joplin，Joplin 仅有此目录的读写权限。如下图：

3.2 Joplin使用WebDAV同步

WebDAV 可以自建，或使用支持 WebDAV 的云盘，另外 NAS（如群晖）通常也支持 WebDAV。

**Nextcloud：**Nextcloud是一个开源的免费的自建个人云存储方案，要启用 Nextcloud 同步，你需要在 Nextcloud 中创建一个目录（比如：Joplin），在左下角的“设置”中获取 WebDAV 的 URL，在 Joplin 同步设置中，填入 WebDAV URL、用户名和密码。

有关于Nextcloud安装与使用教程，请参考：Oneinstack安装NextCloud以及使用Aria2离线下载和ocDownloader插件配置。

**坚果云：**首次同步时会因为 WebDAV 短时间内的大量请求被坚果云临时限制，坚果云提示为“Too many requests”，这个封锁会持续大约6小时。同步之前，在 Joplin 的“工具” > “选项” > “同步” > “高级选项”中，将“最大并发连接数”改为1可以有效避免。

关于坚果云的使用方法，请参考：巧用又拍云FTP和坚果云WebDAV-打造个人文件备份和数据云存储。

四、Joplin导入与导出

Joplin可以很方便地支持从Evernote（印象笔记）导入，方法如下：

从 Evernote（印象笔记）导入：

打开 Evernote，右击要导出的笔记本，选择“导出笔记“，导出 .enex 格式文件。

在 Joplin 中，选择“文件” > “导入” > “ENEX – Evernote导出文件（Markdown）”即可导入。

从 Markdown 文件导入：

使用 Joplin 可以轻松导入 Markdown 文件或整个目录，选择“文件” > “导入” > “MD – Markdown（文件/目录）”导入即可。

从其他应用程序导入：

通常，很多应用程序都支持导入到 Evernote 中，所以从其他应用程序导入的思路是先导入 Evernote，再导出 .enex 文件，最后导入 Joplin 中。

如下图：

如果哪天你不想使用Joplin了，也可以很方便地导出。Joplin 支持多种导出格式，导出格式均为标准格式，可以在不依赖 Joplin 的情况下查看、编辑，部分格式支持无损/有损重新导入：

JEX：Joplin 的无损导出格式，包含所有的元数据如标签、更新时间等。JEX是实际上是一个tar文件，可以直接解压出 MarkDown 文件。这种格式常用于备份，可以无损重新导入。

RAW：同 JEX 格式相似，只是数据会保存为目录，并且每个笔记都会导出为一个单独的文件。可以无损重新导入。

JSON：导出为 JSON 格式的文件。不支持重新导入。

MD：按照笔记本的分级结构导出为目录，每条笔记在对应的目录中导出为 Markdown 格式的文件，目录名和文件名与原笔记本对应，此种格式易于读取，但是导出的文件将丢失元数据。可以有损导入（丢失元数据）。

HTML：导出为网页文件，将 Markdown 格式转为 html 标签，带有样式。不支持导入。

PDF：将单个笔记导出为 PDF 格式的文件。不支持导入。

如下图：

五、总结

免费开源的笔记Joplin无论在功能上还是使用体验上基本上与Evernote印象笔记无异了，在隐私保护方面做得非常好，特别适合那些想要保存个人信息笔记的用户。

使用免费开源的笔记Joplin最大的问题就是找好同步的网盘或者云存储，另外强烈建议大家在对Joplin的设置进行调整时先备份一个，以免同步后删除了所有的笔记。

编辑整理 From：挖站否

系列教程

笔记系列

Gitbook使用系列

Gitlab 使用系列

Hexo系列

[十万字图文教程]基于Hexo的matery主题搭建博客并深度优化完全一站式教程

markdown 各种其它语法插件，latex公式支持，mermaid图表，plant uml图表，URL卡片，bilibili卡片，github卡片，豆瓣卡片，插入音乐和视频，插入脑图，插入PDF，嵌入iframe

Joplin 入门指南&实践方案

2021-09-09T03:25:00.000Z

Evernote笔记该有的功能Joplin都有了，如果你不想掏钱购买Evernote付费版本，Joplin将是最佳的替代品。更多的自建服务还有：

PS：更新记录

1、平时经常要校对文本，以及有大量的文件需要在电脑和移动硬盘同步，可以试试这些免费的同步对比工具：八大免费的文件对比同步工具-免费文件对比分析与复制同步备份软件。2021.3.24

2、对于1Password这类的密码管理软件重度依赖，但是苦于囊中羞涩的话，不防自建密码管理平台：Bitwarden自建密码存储系统图文教程-开源免费的bitwarden_rs安装与使用。2020.10.10

一、Joplin安装和使用

网站：

https://joplinapp.org/

直接到官网下载Joplin安装包，安装好了就可以启动Joplin了，以下是Joplin的软件界面，分成三栏，和我们平时熟悉的笔记软件是一样的。（点击放大）

这是Joplin的编辑器，支持 MarkDown，图片、数学公式、复选框等 MarkDown 语法。

不习惯MarkDown，直接切换为可视编辑即可。

在Joplin的设置选项中还提供了非常多的MarkDown的插件，对于MarkDown深度用户来是一个福音。

二、Joplin的特色功能

2.1 笔记历史版本

2.2 E2EE安全加密

**注意：不要在多个设备上同时启用加密，否则可能会造成加密密钥问题。特别提醒：**加密之前，先将笔记导出JEX备份一份，以防万一。

2.3 Joplin手机APP

Joplin可以直接在各大应用市场上下载，使用起来也很方便。

2.4 外部编辑器

你可以在“工具” > “选项” > “通用选项”中指定编辑器的路径。

三、Joplin同步与备份

3.1 Joplin免费网盘同步

目前，Joplin支持Dropbox 、OneDrive 网盘同步，在同步选项中选择OneDrive，然后就会打开认证。

同意验证。

与 OneDrive 同步时，Joplin 会在 OneDrive 中创建一个子目录：/Apps/Joplin，Joplin 仅有此目录的读写权限。如下图：

3.2 Joplin使用WebDAV同步

WebDAV 可以自建，或使用支持 WebDAV 的云盘，另外 NAS（如群晖）通常也支持 WebDAV。

有关于Nextcloud安装与使用教程，请参考：Oneinstack安装NextCloud以及使用Aria2离线下载和ocDownloader插件配置。

关于坚果云的使用方法，请参考：巧用又拍云FTP和坚果云WebDAV-打造个人文件备份和数据云存储。

四、Joplin导入与导出

Joplin可以很方便地支持从Evernote（印象笔记）导入，方法如下：

从 Evernote（印象笔记）导入：

打开 Evernote，右击要导出的笔记本，选择“导出笔记“，导出 .enex 格式文件。

在 Joplin 中，选择“文件” > “导入” > “ENEX – Evernote导出文件（Markdown）”即可导入。

从 Markdown 文件导入：

使用 Joplin 可以轻松导入 Markdown 文件或整个目录，选择“文件” > “导入” > “MD – Markdown（文件/目录）”导入即可。

从其他应用程序导入：

通常，很多应用程序都支持导入到 Evernote 中，所以从其他应用程序导入的思路是先导入 Evernote，再导出 .enex 文件，最后导入 Joplin 中。

如下图：

JEX：Joplin 的无损导出格式，包含所有的元数据如标签、更新时间等。JEX是实际上是一个tar文件，可以直接解压出 MarkDown 文件。这种格式常用于备份，可以无损重新导入。

RAW：同 JEX 格式相似，只是数据会保存为目录，并且每个笔记都会导出为一个单独的文件。可以无损重新导入。

JSON：导出为 JSON 格式的文件。不支持重新导入。

MD：按照笔记本的分级结构导出为目录，每条笔记在对应的目录中导出为 Markdown 格式的文件，目录名和文件名与原笔记本对应，此种格式易于读取，但是导出的文件将丢失元数据。可以有损导入（丢失元数据）。

HTML：导出为网页文件，将 Markdown 格式转为 html 标签，带有样式。不支持导入。

PDF：将单个笔记导出为 PDF 格式的文件。不支持导入。

如下图：

五、总结

编辑整理 From：挖站否

系列教程

笔记系列

Gitbook使用系列

Gitlab 使用系列

Hexo系列

[十万字图文教程]基于Hexo的matery主题搭建博客并深度优化完全一站式教程

markdown 各种其它语法插件，latex公式支持，mermaid图表，plant uml图表，URL卡片，bilibili卡片，github卡片，豆瓣卡片，插入音乐和视频，插入脑图，插入PDF，嵌入iframe

完美笔记进化论

2021-07-25T08:25:00.000Z

前言：

受够了一些网络服务随意被关闭，如google reader等。经过google doc, 有道笔记，为知笔记，手机备忘录，记事本，git，等等方式记录笔记，使用过txt，word，gitbook，markdown等格式，找到一种接近完美的解决记录笔记的方式。主要采用selfhost，自主搭建服务器，每个组件都可以被取代，大多数都是开源可定制的。

经历了很长时间，使用了各种各样的方案，最终选择了一种相对完美的方式。docker私有部署运行的joplin，使用markdown语法，github作为图床，picgo作为图像自动上传后端，Typora作为MD编辑器，Snipaste作为截图工具。采用gitlab ee docker selfhost备份，VPS自建图床DNS多线负载均衡。cloudflare partner cdn加速，jsdelivr加速。

笔记进化历史

浏览器书签

优点：使用方便，一些实时更新的内容可以直达。

缺点：需要联网，没办法搜索编辑，经常有链接失效。很多有实效的资源，或者可能只能存在一定时间的资源。

由于时效更新的缘故，一直和其它笔记记录方式一起使用。

word笔记

优点：富文本支持

缺点：word相对笨重，很多低端平台没有word可用

txt笔记

优点：多平台，随时随地，格式简单

缺点：富文本支持不好，同步机制只能自己想办法，没有富文本

gitbook

优点：同步机制，修改版本机制

缺点：富文本相对缺乏

单独来说只解决了修改日志问题

markdown

优点：富文本

缺点：无修改日志，显示上传不友好

单独来说解决了富文本问题

google doc

优点：在线编辑，富文本支持，修改历史支持，搜索支持。

缺点：文件是google专有格式，数据保存在网上，国内访问需要代/理支持，google还有关闭热度不高网络服务先例。

有道笔记

优点：对markdown支持非常好

缺点：收费，多平台不够友好，同步问题

手机’'备忘录"app

优点：方便，随时随地

缺点：一般只能同型号手机之间同步，对于多平台同步没有支持，也没有富文本，没有修改历史。

最终选择方案

为知笔记docker版+Typora+Picgo+github+snipaste

最近替换wiznote为Joplin，完全开源免费。Joplin插件异常强大，支持各种Markdown语法。

wiznote docker版作为笔记管理搜索工具，typora作为markdown编辑器，只使用markdown格式笔记，Picgo作为图上上传工具，github作为图像图床，Snippaste作为截屏工具。一起组成笔记工具链。

怎么样？够复杂吧，作者也觉得很复杂，但整体免费，满足selfhost，富文本，多平台，版本管理，目录管理，可搜索，对图像友好的苛刻要求，超越市面所有产品，wiznote 还可以对外网提供服务。

优点：selfhost，富文本，多平台，版本管理，目录管理，可搜索，对图像友好。只使用其中部分功能，每个功能都是有其它可替代方案

缺点：配置异常复杂，配置完整难度较高，一些组件还不够成熟，稳定性不够好，存在bug

wiznote docker版

数据完整保存在自己搭建的服务器上面，备份转移方便。其实主要是使用wiznote docker版的目录管理，多文档搜索，修改记录功能。可以使用gitlab docker版来代替。

教程：为知笔记私有化Docker部署

最近更新 Joplin docker +Typora+VIM + Picgo+github+snipaste

最近抛弃了wiznote，全面投入了Joplin的怀抱

选用理由： 从服务器到客户端，到APP完全开源，支持dropbox，webdav，本地文件系统，docker镜像等同步方式。

Jopin配合Typora才是最佳搭档, 配置如下

Joplin

Joplin教程：

替代Evernote免费开源笔记Joplin-网盘同步笔记历史版本Markdown可视化

Joplin 入门指南&实践方案

Joplin 插件使用推荐

官方插件下载地址

中文界面

工具–>选项

点击下方图的按钮来触发Joplin设置的外部编辑器

把 Joplin 用在日常工作中

此处主要介绍 Joplin 在终端中的使用，主要参考了官方文档。

和 Vim 协作编辑文档

我喜欢 Joplin 终端的设计，它很符合 tmux 和 Vim 的逻辑。

终端 Joplin 由三个横向的 Panel 组成，切换的时候用 tab 和 Shift-Tab。为了使得它更符合 Vim 的风格（Control + 方向键），可以在 ~/.config/joplin/keymap.json 中加入以下的设置（完整版见此 gist keymap.json ）：

...
        { "keys": ["TAB","l"], "type": "function", "command": "focus_next" },
        { "keys": ["SHIFT_TAB","h"], "type": "function", "command": "focus_previous" },
        { "keys": ["UP","k"], "type": "function", "command": "move_up" },
        { "keys": ["DOWN","j"], "type": "function", "command": "move_down" },
        { "keys": ["PAGE_UP","K","{"], "type": "function", "command": "page_up" },
        { "keys": ["PAGE_DOWN","J","}"], "type": "function", "command": "page_down" },
...

这样就变成了 HJKL 风格了。

选择好要编辑的笔记之后，回车就会用默认的终端编辑器打开了。对我来说，必然是 Vim。要注意的是编辑中的语法高亮需要加入 vim-markdown.vim，预览则要 markdown-preview.nvim。

利用 CLI 快速记录

假设你正在工作环境中（例如 Shell 下、tmux 下或着 Vim 下），不想离开终端，更不想离开现在的窗口，这种情况下 Joplin 的命令行介面就很有帮助了。你可以快速记录、查询一些笔记内容。

我在这里写了一些例子供你参考。

创建一个笔记本 = 为项目建立日志存储：

$ joplin mkbook "My-Project"
$ joplin use "My-Project"

创建新笔记并以当前时间命名 = 记录当前进度：

$ joplin mknote `date +%Y/%m/%d`

查看已有的笔记：

$ joplin ls -l

完成当前进度：

$ joplin todo toggle "Feature1"

更多的命令行，你可以通过 joplin help all 查看。

Joplin 插件以及Markdown语法

教程： Joplin 插件以及其Markdown语法

Gitlab docker

和上面的wiznote docker基本一样的使用功能。

除了记录笔记，还可以保存自己的各种代码。

Typora

Typora官方介绍及下载地址

编辑器演示

上传图片图示

后端图像上传工具picgo

一次性上传本MD文件中所有图片

picgo

Picgo官方下载地址

官方插件下载地址及其介绍

picgo插件配置

要想picgo用的过得去，一般来说需要插件

picgo使用github作为图床需要github配置，也可以使用sm.ms， gitee。选择github相对来说被随意关闭可能性更低。

Picgo 上传 gif 后变为静态图片？

图片内容上右键复制图片只会读取成png。你如果要上传GIF，win10可以直接在系统里右键图片文件，有一个upload with PicGo选项，可以直接上传原图片。或者拖拽上传都可以

Snipaste截图工具

Snipaste官方下载地址

系列教程

笔记系列

Gitbook使用系列

Gitlab 使用系列

Hexo系列