Obsidian、Typora和Logseq的通用Markdown语法 - 少数派
date_saved: 2024-03-10 20:48:05
date_published: 2024-03-10 20:48:05
Full Content:
Obsidian、Typora和Logseq的通用Markdown语法
为什么要用通用语法
Obsidian、Typora和Logseq各有各的优点。
Obsidian：有强大的文件管理功能，但是编辑体验差强人意，比如回车不能更换段落、插入图片必须回车才能继续写。
Typora：有非常好的编辑体验，但是文档多了就不好管理。
Logseq：主要侧重于大纲。
通用语法的好处就是可以用不同的软件编辑，结合各种优点，而且在不同软件上的显示、渲染几乎相同。
比如我一般同时打开Obsidian和Typora，用Typora来编辑，然后用Obsidian整理，只要在Typora里设置启动选项，指定到Obsidian库的文件夹即可，如下图。Logseq则是用大纲来整理思路。
Typora启动设置
只使用通用语法的坏处就是显示效果不好，因为不能用软件的特殊语法，有时候编辑起来比较麻烦。
比如在Obsidian中，只需要输入前一半的字符，就能渲染，而在Typora中必须输入完整。还有Obsidian中的特殊语法可以用来显示文件的类型，而Typora中不行。
开始的一些介绍
本文主要介绍一些“链接”的通用语法，其他Markdown语法在这里简单介绍。
标题：###+空格+标题内容
斜体：*斜体内容*
粗体：**粗体内容**
高亮：高亮内容
有序列表：1.+空格+内容
无序列表：-+空格+内容
分隔线：***+回车，或者---+回车
任务列表：-+空格[+空格]+空格+待办
各种链接语法
重点：
- 下面的所有语法，其中的符号，包括感叹号!、中括号[]、小括号()全部是英文半角。
- 当链接、路径中有空格时，Obsidan无法识别，但是Typora、Logseq可以。
为了在Obsdian里也能识别，即为了达到各个软件显示效果一样，以下有两种方法：
- 将链接、路径重新编码，比如“空格”的编码为“%20”，但这种方法麻烦。
- 给链接、路径加上“<>”，软件读取时会自动编码，这样方便一些。下文的所有链接、路径只要是有可能出现编码问题的，我都会加**“<>”。**
网址的链接
语法：[链接的文字](链接的网址)
比如：[百度](https://www.baidu.com)
网页图片的链接
语法：
比如：
注：“网址的链接”和“网页图片的链接”本身无空格，所以不需要加**“<>”。**
本地图片的链接
绝对链接（不太推荐）
语法：
比如：，注意图片名称一定要包括扩展名。
相对路径（推荐）
推荐相对路径是因为，当需要把md源码交给别人时，直接复制文件夹给别人，别人也能看到图片（图床也行）。
相对路径是指图片相对于当前md文件，所处的位置。
比如：./assets/hhhh.png，是指与当前md同级的文件夹，里面有hhhh.png图片，如下图所示。
注：./assets/hhhh.png和assets/hhhh.png没区别，都表示同级的文件夹。
同级文件夹
另如：../assets/001.png，是指当前md文件的上一级文件夹里面，有个assets文件夹，里面有一张hhhh.png图片，如下图所示。
上级文件夹
语法：
比如：
关于图片的整理，我一般会给每一个文件夹里面，都创建一个assets文件夹，用来储存图片。
为了方便我们拽托图片，就直接复制图片到assets文件夹，同时插入相对路径，我们可以按下图设置Typora。
Typora的图片设置
按下图设置Obsidian
Obsidian的图片设置
任意类型文件的链接
同样有相对路径和绝对路径之分，以下我用绝对路径举例，相对路径同理即可。
语法：[可选填入的文字](<文件的路径>)
比如：[RSS阅读器比较](<C:\Users\OneDrive\Excalidraw\RSS阅读器比较.excalidraw>)
若电脑上安装了相应软件能打开“.excalidraw”文件，则你点击Markdown里的链接就会打开这个文件。
需要说明的是，上述链接也可以链接图片，但是就只显示“可选填入的文字”，不会在Markdown里显示预览图。
注意事项：
- 任意类型的文件也可直接拖到Markdown笔记中。若是往Typora中拖入不能识别的文件（非图片类），会创建一个链接（可在“偏好设置”-“文件”里设置）。且若Markdown文件和不能识别的文件在同一个磁盘，会创建相对路径；若是在不同磁盘，会创建绝对路径。
- 若是往Obsidian中拖入不能识别的文件（应该也是非图片类，我没全部测试），按照我上面的Obsidian附件设置，会直接复制到assets文件夹中，并创建相对路径。
文件夹的链接
同样有相对路径和绝对路径之分，以下我用绝对路径举例，相对路径同理即可。
若我们需要在笔记中打开电脑上的某个文件夹，就需要使用这个链接。
语法：[可选填入的文字](<文件夹在电脑上的路径>)
比如：
[Excalidraw文件夹](<C:\Users\OneDrive\Excalidraw>)
以及：
[203Excalidraw文件夹](file://C:\\Users\\OneDrive\\Excalidraw)
这两种方式，在三款笔记软件里都可以打开文件夹。
双链的链接
双链有两种形式
一种是Markdown
语法：[填入笔记名称](要链接的笔记的位置)
如：[模板文件](通用的模板.md)
注：这里的“(要链接的笔记的位置)”没有加“<>”的原因是，我们很少自己手动创建双链，一般都是在Obsidan里按两下中括号“[[”创建双链。如果需要自己创建双链，有需要也可以加上“<>”。
另一种是Wiki链接
语法：笔记的名称
如：前言模板
这两种在Obsidian里都能识别，但是Typora只能识别Markdown类型的，因此我们可以在Obsidian的“文件与链接”设置里，关闭“使用Wiki链接”。
Obsidian关闭“使用Wiki链接”
虽然在Obsidian里关闭了Wiki链接，但任然可以在键盘上按两下中括号“[[”快速创建双链，创建出来的是带相对路径的，Markdown形式的双向链接。
双向链接的两种延伸形式
Markdown形式和Wiki形式在用法是没区别，都是按两下中括号“[[”创建，我下面以Wiki举例。
链接某篇文章的标题
语法：输入文章的名称
链接某篇文章的某个内容块
需要注意的是，这两种形式都需要在Obsidian里创建，并且在Obsidian和Typora中可用，但是在Logseq中不可用。
其他更多语法就不介绍了，对于我来说，上面的这些语法已经够用了。
总结
- 以上语法大致就两类，一类是图片，；一类是链接，[可选填入的文字](链接)。
- 我列举了这些语法的各种应用，帮助大家理解。
- 我在少数派看过一篇文章，大致意思是“重器轻用”，我非常赞同，没必要对什么东西都了如指掌，按自己的需求用就行。Obsidian是一款强大的笔记软件，但我只用基础功能，个人意见，仅供参考。
感谢观看！
Highlights
为什么要用通用语法
Obsidian、Typora和Logseq各有各的优点。
Obsidian：有强大的文件管理功能，但是编辑体验差强人意，比如回车不能更换段落、插入图片必须回车才能继续写。
Typora：有非常好的编辑体验，但是文档多了就不好管理。
Logseq：主要侧重于大纲。 ⤴️
通用语法的好处就是可以用不同的软件编辑，结合各种优点，而且在不同软件上的显示、渲染几乎相同。 ⤴️