Obsidian 从入门到精通

Obsidian的安装,介绍和高阶使用

本文主要是介绍Obsidian的快速入门,链接,插件,Obsidian Web Clipper
摘要
Obsidian 黑曜石笔记间建立双向链接,并且可以探索这些笔记,连接形成的关系图谱。包括快速入门,导入笔记,用户界面,编辑与格式化,链接笔记与文件等操作,同样可以使用坚果云进行多设备同步

1. 背景

Obsidian 既是一个 Markdown 编辑器,也是一个知识库应用。以最基本的方式使用时,你可以编辑和预览 Markdown 文件。但它真正的强大之处在于管理一个紧密互联的知识库

  1. Obsidian是由Shida Li和徐子殷于2019冠状病毒病疫情隔离期间所编写的,两人在滑铁卢大学学习时相识

  2. 2020年,发布了第一个版本,obsidian 1.0

    • 本地Markdown文件
    • 双向链接[[note]]
    • 图谱视图
    • 插件化结构

远程工作 + 自我学习需求暴涨 → PKM(Personal Knowledge Management)爆发

  1. 2020-2021年,Obsidian没有走传统SaaS路线,而是强调本地化和拓展,这一阶段插件生态崛起

  2. 2021年-2023年,这个阶段Obsidian开始成为主流的个人知识库管理工具,各类标志性功能的完善和明确的商业模式;还有新功能(Canvas(类似白板),Bases数据库等)

  3. Obsibian CEO下场写Skills,联合Claude Code使用,还有2026年LLM wiki的催化更是引爆了这款软件

注记

哲学理念

心灵对简单观念施加其能力的活动,主要有以下三种:

  • 将若干简单观念组合为一个复合观念,所有复杂观念就是这样形成的
  • 第二种是将两个观念,无论是简单的还是复杂的,放在一起并排对照观察,而不将它们合二为一,心灵由此获得了所有关于关系的观念
  • 第三种是将它们从现实存在中伴随它们的所有其他观念中分离出来:这称为抽象,所有一般性观念就是这样形成的

2. 下载安装

  1. 直接点击windows下载链接
  2. 打开安装文件,按照指示操作
  3. 安装完成后,像应用一样打开即可
  1. 直接点击macOS下载链接
  2. 在打开的窗口中,将 Obsidian 拖动到”应用程序”文件夹中
  3. 安装完成后,像App一样打开即可,推出安装文件即可

不同的系统需要不同的安装方法,具体参考官网

  1. Play 商店上找到 Obsidian。
  2. 点击安装下载应用
  3. 安装完成后,按打开其他应用一样的方法打开 Obsidian
  1. 在 App Store上找到 Obsidian
  2. 点击获取下载应用
  3. 安装完成后,按打开其他应用一样的方法打开 Obsidian

3. 快速入门

3.1 创建仓库

Obsidian 将所有笔记保存在仓库中。仓库本质上是本地文件系统中的一个文件夹。你可以将所有笔记保存在一个仓库里,也可以为不同的项目创建不同仓库。

  • 本地仓库:将所有笔记保存在本地文件系统中的一个文件夹中
  • 远程仓库:将所有笔记保存在远程服务器上,如GitHub、GitLab、坚果云等

第一次打开 Obsidian 时,Obsidian 会询问你是否要创建一个新仓库。此时你有两个选择,你可以创建一个新仓库,或者将现有文件夹作为仓库打开。

  1. 如图界面创建一个新的仓库:

new valutue

  • 新建仓库
  • 仓库名称:给新仓库起一个名字,指定仓库位置
  • 点击创建即可
  1. 将已有文件夹作为仓库打开

当然你可以把直接新建文件夹之后,把文件夹作为仓库打开,同样的操作

注记

文件夹即为仓库就能有很多操作,你可以把文件夹使用git进行追踪利用github进行同步,如果图片多内容多你也可以使用坚果云作为云盘存储同步,安装好之后直接把坚果云中的文件夹作为仓库,每天上传1G,下载3GB的流量应该是足够用

cloud file

  1. 在主面板进行创建仓库

在主面板中切换和创建仓库都在左下脚的位置,点击左下角当前仓库的名字,弹出之后选择切换的仓库或者管理仓库即可

change value

  1. 沙盒仓库

Obsidian 的沙箱仓库是一个让你在不影响现有数据的情况下探索各种功能的特性。该仓库既可以作为学习工具,也可以用于调试问题。它有助于判断问题是由插件、主题还是应用本身引起的。

提示

沙箱仓库在移动设备上不可用

同样在主板页面,切换仓库的旁边,点击帮助图标(?),然后在沙箱仓库旁边选择选择打开即可

sandbox value

沙箱仓库内部有很多简要的使用说明可以查看,包括常见的语法等

要关闭沙箱仓库,请关闭 Obsidian Sandbox 仓库窗口

3.2 创建笔记

Obsidian 中的笔记以纯文本文件的形式存储。这意味着你的数据是持久的,不会被锁定在某种专有格式中。通过用纯文本书写笔记,它们将比任何应用都更长久——甚至包括 Obsidian 本身。

create new note

  1. 点击左上角新建笔记,创建新的笔记
  2. 输入名称”入门markdown语法”作为笔记名称,确认即可
  3. 右上角处有三个点(…)的选项中比较重要的是阅读模式源模式
    • Obsidian也有所见即所得模式
    • 阅读模式下无法进行修改
    • 源模式开启显示基础的语法,关闭之后显示语法的渲染结果

3.2.1 Obsidian基础语法(兼容Markdown)

下面是Obsidian和Markdown基础语法的了解,相当于用法,还是需要熟能生巧

  1. 段落

在 Markdown 中创建段落,需使用空行来分隔文本块。每个由空行分隔的文本块都被视为独立的段落

这是一个段落

这是另一个段落
  1. 换行 在 Obsidian 中,默认情况下按一次 Enter 会在笔记中创建新行,但在渲染输出中,这被视为同一段落的延续,这遵循了典型的 Markdown 行为。要在段落内插入换行而不开始新段落
  • 在按 Enter之前在行末添加两个空格
  • 使用快捷键 Shift+Enter 直接插入换行

在设置中–编辑器选项卡–启动严格执行后就必须使用markdown的换行逻辑,而Obsidian默认情况下是关闭严格执行的,在预览模式下按Enter会直接换航

  1. 标题 要创建标题,在标题文本前添加最多六个 # 符号。# 符号的数量决定标题的级别
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

一二级标题默认会自动生成分隔线,小标题是没有

  1. 加粗、斜体、高亮 可以通过在格式符号前添加反斜杠  来强制以纯文本显示
样式 语法 示例 输出
加粗 ** **__ __ **加粗文本** 加粗文本
斜体 * *_ _ *斜体文本* 斜体文本
删除线 ~~ ~~ ~~删除线文本~~ 删除线文本
高亮 == == ==高亮文本== ==高亮文本==
加粗和嵌套斜体 ** ** 和 _ _ **加粗文本和_嵌套斜体_文本** 加粗文本和_嵌套斜体_文本
加粗和斜体 *** ***___ ___ ***加粗和斜体文本*** 加粗和斜体文本
  1. 内部链接

内部链接相当于整个文件夹内的相互引用或者相互跳转,支持两种方式

  • Wiki链接:[[笔记名称]]
  • 文件链接:[笔记名称](@/路径/笔记名称.md)
  1. 外部链接 如果你想链接到外部 URL,可以用方括号([ ])包围链接文本,然后用圆括号(( ))包围 URL 来创建内联链接。
[Obsidian 帮助](https://help.obsidian.md)

也可以通过链接到Obsidian URI来创建指向其他仓库中文件的外部链接

注记

Obsidian URI 是 Obsidian 支持的自定义 URI 协议,可以让你触发各种操作,例如打开笔记或创建笔记。Obsidian URI 使自动化和跨应用工作流成为可能

  • 格式:obsidian://action?param1=value&param2=value

转义链接中的空格

如果URL 包含空格,必须将空格替换为%20来转义它们

[我的笔记](obsidian://open?vault=MainVault&file=My%20Note.md)

或者使用尖括号(< >)包裹URL来转义 [我的笔记](<obsidian://open?vault=MainVault&file=My Note.md>)

  1. 图片

markdown标准图片引用方式如下

![Engelbart](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg)

Obsidian中,可以在链接中添加|640x480来改变图片的尺寸,其中640是宽,480是高

![Engelbart|100x145](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg)

如果只指定宽度,图片会按原始宽高比缩放

3.3 导入笔记

4. 用户界面

5. 链接笔记与文件

6. 插件

7. 数据库和文件夹

8. Obsidian Web Clipper

9. 第三方插件