Obsidian、Typora和Logseq各有各的优点。
Obsidian:有强大的文件管理功能,但是编辑体验差强人意,比如回车不能更换段落、插入图片必须回车才能继续写。
Typora:有非常好的编辑体验,但是文档多了就不好管理。
Logseq:主要侧重于大纲。
通用语法的好处就是可以用不同的软件编辑,结合各种优点,而且在不同软件上的显示、渲染几乎相同。
比如在Obsidian中,只需要输入前一半的字符,就能渲染,而在Typora中必须输入完整。还有Obsidian中的特殊语法可以用来显示文件的类型,而Typora中不行。
本文主要介绍一些“链接”的通用语法,其他Markdown语法在这里简单介绍。
标题:###+空格+标题内容
斜体:*斜体内容*
粗体:**粗体内容**
高亮:==高亮内容==
有序列表:1.+空格+内容
无序列表:-+空格+内容
分隔线:***+回车,或者---+回车
任务列表:-+空格[+空格]+空格+待办
重点:
- 下面的所有语法,其中的符号,包括感叹号!、中括号[]、小括号()全部是英文半角。
- 当链接、路径中有空格时,Obsidan无法识别,但是Typora、Logseq可以。
为了在Obsdian里也能识别,即为了达到各个软件显示效果一样,以下有两种方法:
- 将链接、路径重新编码,比如“空格”的编码为“%20”,但这种方法麻烦。
- 给链接、路径加上“<>”,软件读取时会自动编码,这样方便一些。下文的所有链接、路径只要是有可能出现编码问题的,我都会加“<>”。
语法:[链接的文字](链接的网址)
比如:[百度](https://www.baidu.com)
语法:![可选填的文字](网址)
比如:![一张图片](https://img2.baidu.com/it/u=1845469400,959040260&fm=253&fmt=auto&app=120&f=JPEG?w=608&h=246)
注:“网址的链接”和“网页图片的链接”本身无空格,所以不需要加“<>”。
绝对链接(不太推荐)
语法:![可选填入的文字](<图片在电脑中的具体位置>)
比如:![123456](<E:Computer999PicPickhhhh.png>),注意图片名称一定要包括扩展名。
相对路径(推荐)
推荐相对路径是因为,当需要把md源码交给别人时,直接复制文件夹给别人,别人也能看到图片(图床也行)。
相对路径是指图片相对于当前md文件,所处的位置。
比如:https://sspai.com/post/assets/hhhh.png,是指与当前md同级的文件夹,里面有hhhh.png图片,如下图所示。
比如:![这是图片](<https://sspai.com/post/assets/hhhh.png>)
关于图片的整理,我一般会给每一个文件夹里面,都创建一个assets文件夹,用来储存图片。
语法:[可选填入的文字](<文件的路径>)
比如:[RSS阅读器比较](<C:UsersOneDriveExcalidrawRSS阅读器比较.excalidraw>)
若电脑上安装了相应软件能打开“.excalidraw”文件,则你点击Markdown里的链接就会打开这个文件。
需要说明的是,上述链接也可以链接图片,但是就只显示“可选填入的文字”,不会在Markdown里显示预览图。
注意事项:
- 任意类型的文件也可直接拖到Markdown笔记中。若是往Typora中拖入不能识别的文件(非图片类),会创建一个链接(可在“偏好设置”-“文件”里设置)。且若Markdown文件和不能识别的文件在同一个磁盘,会创建相对路径;若是在不同磁盘,会创建绝对路径。
- 若是往Obsidian中拖入不能识别的文件(应该也是非图片类,我没全部测试),按照我上面的Obsidian附件设置,会直接复制到assets文件夹中,并创建相对路径。
同样有相对路径和绝对路径之分,以下我用绝对路径举例,相对路径同理即可。
若我们需要在笔记中打开电脑上的某个文件夹,就需要使用这个链接。
语法:[可选填入的文字](<文件夹在电脑上的路径>)
比如:
[Excalidraw文件夹](<C:UsersOneDriveExcalidraw>)
以及:
[203Excalidraw文件夹](<file://C:UsersOneDriveExcalidraw>)
这两种方式,在三款笔记软件里都可以打开文件夹。
双链有两种形式
一种是Markdown
语法:[填入笔记名称](要链接的笔记的位置)
如:[模板文件](通用的模板.md)
注:这里的“(要链接的笔记的位置)”没有加“<>”的原因是,我们很少自己手动创建双链,一般都是在Obsidan里按两下中括号“[[”创建双链。如果需要自己创建双链,有需要也可以加上“<>”。
另一种是Wiki链接
语法:[[笔记的名称]]
如:[[https://sspai.com/templates/前言模板|前言模板]]
双向链接的两种延伸形式
Markdown形式和Wiki形式在用法是没区别,都是按两下中括号“[[”创建,我下面以Wiki举例。
链接某篇文章的标题
语法:[[输入文章的名称#选中相应的标题]]
链接某篇文章的某个内容块
语法:[[输入文章的名称^选择相应的内容块]]
需要注意的是,这两种形式都需要在Obsidian里创建,并且在Obsidian和Typora中可用,但是在Logseq中不可用。