惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

D
DataBreaches.Net
罗磊的独立博客
雷峰网
雷峰网
量子位
V
Visual Studio Blog
Vercel News
Vercel News
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
The Cloudflare Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
宝玉的分享
宝玉的分享
月光博客
月光博客
Martin Fowler
Martin Fowler
aimingoo的专栏
aimingoo的专栏
H
Hackread – Cybersecurity News, Data Breaches, AI and More
Microsoft Security Blog
Microsoft Security Blog
博客园 - 叶小钗
腾讯CDC
Engineering at Meta
Engineering at Meta
博客园 - Franky
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
Y
Y Combinator Blog
Recent Announcements
Recent Announcements
Jina AI
Jina AI
A
About on SuperTechFans

少数派

派早报:Google 发布 Fitbit Air 等 - 少数派 「新人报到」確認需求,再開始 - 少数派 从 SOLO 独立开发者社区,我看到了越来越多开发者开始做自己的产品 - 少数派 我怎么管理那些"不常做,但总会忘"的生活事项 - 少数派 人形机器人量产元年,数据才是具身智能的“生死线” - 少数派 BuhoLaunchpad 高度还原 Mac 启动台:开发历程与思考 - 少数派 五年陪伴依然不舍,DIY 换壳后让罗技 MX Master 3 继续服役 - 少数派 新玩意 240|少数派的编辑们最近买了啥? - 少数派 一日一技|为什么你应该关闭 iOS 的键盘声音 - 少数派 我做了个插件和 Skills,一键提取任何网站的设计规范 Design.md - 少数派 住在三四线城市的你,该开始录播客了 - 少数派 甘南秘境,大白高国 - 少数派 AI的审美:谁让把我变成川内倫子 - 少数派 返工怎能不烦恼,打工人片单总有一部是你的「嘴替」 - 少数派 为了让「上厕所」更健康,我做了一个小工具 - 少数派 AI + Skill,能够让生成的文章去除 AI 味吗? - 少数派 新玩意|韶音OpenDots ONE 耳夹式耳机 - 少数派 《美满》| 在每一个春天的晚上相爱(362) - 少数派 新玩意|优篮子 PS01 MagSnap 磁吸支架 - 少数派 自我整合手记 | 我开始早睡了:用稳定规则,为自由托底 - 少数派 用龙虾(OpenClaw)两个多月,我最深的12个体会 - 少数派 听歌时间到,12 张你可能错过的 2025 华语乐坛好专辑 - 少数派 承诺能追吗 - 少数派 macOS 26启动台没了? 我做了个不一样的App启动器 - Keboard - 少数派 《四海为家的人》| INTJ对话INTJ(361) - 少数派 你发过的那些黑历史,是时候一次清干净了 - 少数派 新玩意:安安静静玩,越玩越专注:计客密码机 - 少数派 iPad 用户首次体验 Android 平板:vivo Pad6 Pro - 少数派 数据逻辑强 - 少数派 极北行+ | 一路向北,探访日本至北之地 | 001 - 少数派
Obsidian、Typora和Logseq的通用Markdown语法 - 少数派
2024-03-11 · via 少数派

为什么要用通用语法

Obsidian、Typora和Logseq各有各的优点。

Obsidian:有强大的文件管理功能,但是编辑体验差强人意,比如回车不能更换段落、插入图片必须回车才能继续写。

Typora:有非常好的编辑体验,但是文档多了就不好管理。

Logseq:主要侧重于大纲

通用语法的好处就是可以用不同的软件编辑,结合各种优点,而且在不同软件上的显示、渲染几乎相同。

比如我一般同时打开Obsidian和Typora,用Typora来编辑,然后用Obsidian整理,只要在Typora里设置启动选项,指定到Obsidian库的文件夹即可,如下图。Logseq则是用大纲来整理思路。

Typora启动设置

只使用通用语法的坏处就是显示效果不好,因为不能用软件的特殊语法,有时候编辑起来比较麻烦

比如在Obsidian中,只需要输入前一半的字符,就能渲染,而在Typora中必须输入完整。还有Obsidian中的特殊语法可以用来显示文件的类型,而Typora中不行。

开始的一些介绍

本文主要介绍一些“链接”的通用语法,其他Markdown语法在这里简单介绍。

标题:###+空格+标题内容

斜体:*斜体内容*

粗体:**粗体内容**

高亮:==高亮内容==

有序列表:1.+空格+内容

无序列表:-+空格+内容

分隔线:***+回车,或者---+回车

任务列表:-+空格[+空格]+空格+待办

各种链接语法

重点

  1. 下面的所有语法,其中的符号,包括感叹号!、中括号[]、小括号()全部是英文半角
  2. 当链接、路径中有空格时,Obsidan无法识别,但是Typora、Logseq可以。

为了在Obsdian里也能识别,即为了达到各个软件显示效果一样,以下有两种方法:

  1. 将链接、路径重新编码,比如“空格”的编码为“%20”,但这种方法麻烦
  2. 给链接、路径加上“<>”,软件读取时会自动编码,这样方便一些。下文的所有链接、路径只要是有可能出现编码问题的,我都会加“<>”。

网址的链接

语法:[链接的文字](链接的网址)

比如:[百度](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:\Computer999\PicPick\hhhh.png>),注意图片名称一定要包括扩展名

相对路径(推荐)

推荐相对路径是因为,当需要把md源码交给别人时,直接复制文件夹给别人,别人也能看到图片(图床也行)。

相对路径是指图片相对于当前md文件,所处的位置

比如:./assets/hhhh.png,是指与当前md同级的文件夹,里面有hhhh.png图片,如下图所示。

注:./assets/hhhh.png和assets/hhhh.png没区别,都表示同级的文件夹。

同级文件夹

另如:../assets/001.png,是指当前md文件的上一级文件夹里面,有个assets文件夹,里面有一张hhhh.png图片,如下图所示。

上级文件夹

语法:![可选填入的文字](<图片在电脑中的相对路径>)

比如:![这是图片](<./assets/hhhh.png>)

关于图片的整理,我一般会给每一个文件夹里面,都创建一个assets文件夹,用来储存图片。

为了方便我们拽托图片,就直接复制图片到assets文件夹,同时插入相对路径,我们可以按下图设置Typora。

Typora的图片设置

按下图设置Obsidian

Obsidian的图片设置

任意类型文件的链接

同样有相对路径和绝对路径之分,以下我用绝对路径举例,相对路径同理即可

语法:[可选填入的文字](<文件的路径>)

比如:[RSS阅读器比较](<C:\Users\OneDrive\Excalidraw\RSS阅读器比较.excalidraw>)

若电脑上安装了相应软件能打开“.excalidraw”文件,则你点击Markdown里的链接就会打开这个文件。

需要说明的是,上述链接也可以链接图片,但是就只显示“可选填入的文字”,不会在Markdown里显示预览图。

注意事项

  1. 任意类型的文件也可直接拖到Markdown笔记中。若是往Typora中拖入不能识别的文件(非图片类),会创建一个链接(可在“偏好设置”-“文件”里设置)。且若Markdown文件和不能识别的文件在同一个磁盘,会创建相对路径;若是在不同磁盘,会创建绝对路径。
  2. 若是往Obsidian中拖入不能识别的文件(应该也是非图片类,我没全部测试),按照我上面的Obsidian附件设置,会直接复制到assets文件夹中,并创建相对路径。

文件夹的链接

同样有相对路径和绝对路径之分,以下我用绝对路径举例,相对路径同理即可

若我们需要在笔记中打开电脑上的某个文件夹,就需要使用这个链接。

语法:[可选填入的文字](<文件夹在电脑上的路径>)

比如:

[Excalidraw文件夹](<C:\Users\OneDrive\Excalidraw>)

以及:

[203Excalidraw文件夹](<file://C:\Users\OneDrive\Excalidraw>)

这两种方式,在三款笔记软件里都可以打开文件夹。

双链的链接

双链有两种形式

一种是Markdown

语法:[填入笔记名称](要链接的笔记的位置)

如:[模板文件](通用的模板.md)

注:这里的“(要链接的笔记的位置)”没有加“<>”的原因是,我们很少自己手动创建双链,一般都是在Obsidan里按两下中括号“[[”创建双链。如果需要自己创建双链,有需要也可以加上“<>”

另一种是Wiki链接

语法:[[笔记的名称]]

如:[[../templates/前言模板|前言模板]]

这两种在Obsidian里都能识别,但是Typora只能识别Markdown类型的,因此我们可以在Obsidian的“文件与链接”设置里,关闭“使用Wiki链接”

Obsidian关闭“使用Wiki链接”

虽然在Obsidian里关闭了Wiki链接,但任然可以在键盘上按两下中括号“[[”快速创建双链,创建出来的是带相对路径的,Markdown形式的双向链接。

双向链接的两种延伸形式

Markdown形式和Wiki形式在用法是没区别都是按两下中括号“[[”创建,我下面以Wiki举例

链接某篇文章的标题

语法:[[输入文章的名称#选中相应的标题]]

链接某篇文章的某个内容块

语法:[[输入文章的名称^选择相应的内容块]]

需要注意的是,这两种形式都需要在Obsidian里创建,并且在Obsidian和Typora中可用,但是在Logseq中不可用

其他更多语法就不介绍了,对于我来说,上面的这些语法已经够用了。

总结

  1. 以上语法大致就两类,一类是图片,![可选填入的文字](图片的链接);一类是链接,[可选填入的文字](链接)。
  2. 我列举了这些语法的各种应用,帮助大家理解。
  3. 我在少数派看过一篇文章,大致意思是“重器轻用”,我非常赞同,没必要对什么东西都了如指掌,按自己的需求用就行。Obsidian是一款强大的笔记软件,但我只用基础功能,个人意见,仅供参考。

感谢观看!