Obsidian基本使用文档
Obsidian基本使用文档
Obsidian是什么
Obsidian是一款本地优先的知识管理工具，专为构建个人知识体系设计。其核心特点包括：
- Markdown为核心：支持完整语法扩展
- 网状知识链接：双向链接+关系图谱
- 模块化扩展：类似VSCode的插件生态（200+官方/社区插件）
- 数据可控：标准Markdown格式本地存储，支持Git版本管理
- 全平台覆盖：Win/MacOS/Linux/Android/iOS
为什么使用Obsidian
- 完整的Markdown支持：原生支持所有标准Markdown语法及扩展语法
- 白板（Canvas）：支持多类型内容混排，可自由布局文字、图片、网页等元素
- 知识图谱构建：
- 双向链接支持正反向跳转
- 自动生成可视化关系图谱
- 多端同步方案：
- 官方同步服务（付费）
- 通过obsidian-git插件实现免费Git同步
- AI集成：支持通过插件集成多种AI工具，实现智能问答和知识库构建
- 科学公式编辑：原生支持LaTeX数学公式
- 高度可定制化：
- 界面主题CSS可自定义
- 多仓库独立配置
- 支持嵌套仓库管理
安装
推荐下载渠道：
- 官网（需科学上网）：http://obsidian.md/download
- 百度网盘（国内用户）：https://pan.baidu.com/s/1RnBGVQPqJNv0btpKNZYLIA 提取码: hy16
系统兼容性：
- 官方支持：Android/iOS/Windows/MacOS/Linux
- 鸿蒙系统：可通过APK安装（需自行验证兼容性）
基本使用
在使用Obsidian之前，需要熟悉Obsidian中的一些基本操作。
Markdown语法
使用Obsidian，Markdown是必须要掌握的，因为这是一个基于Markdown的文本编辑器。
什么是Markdown
[! info] 维基百科
Markdown 是一种轻量级标记语言，用于使用纯文本编辑器创建格式化文本。John Gruber 在 2004 年创建了 Markdown，作为一种易于阅读的标记语言。Markdown 广泛用于博客和即时通讯，也用于在线论坛、协作软件、文档页面和自述文件中的其他地方。
Markdown 是一种轻量级标记语言，通过简单的纯文本符号（如
- ）来实现标题、列表、链接等排版格式。它可以用普通文本编辑器编写，并能轻松转换为HTML等格式，特别适合快速书写和网络内容创作。
学习Markdown
推荐学习渠道：
- markdown中文文档：https://markdown.com.cn/basic-syntax/
- markdown官方文档：https://www.markdownguide.org/
核心语法速查
元素 语法
标题 # H1## H2（最多六级）
列表 - 无序或1. 有序
链接 显示文本
图片
代码块 [语言名]代码
行内代码块 代码
强调 粗体斜体
引用 > 引用内容
分割线 三个及以上---或***
数学公式块 $$latex数学公式$$
行内数学公式块 $latex数学公式$
Obsidian基础控件
仓库管理
项目安装完成之后一般可以看到一个项目默认仓库
Obsidian Sandbox
，是一个全英文的Obsidian官方文档，有兴趣的朋友可以打开查看。
[! WARNING] 警告
这是一个沙箱仓库，用户在里面所做的所有操作不会被保存
因此，用户只能在里面做一些测试
记录笔记、构建知识库，需要创建一个新的仓库
首次创建仓库
[! info] 官方文档
In Obsidian, a vault is a plain folder on your computer. By plain, I mean it’s just like a folder you created and put some files in. You can open it with your system explorer or Finder, zip it up, make a copy, or move it around.
正如官网所说：Obsidian仓库就只是本地的一个文件夹
只需完成以下四个步骤：
- 点击"创建"按钮
- 命名规范：
- 支持中文/英文命名
- 禁止包含特殊字符：
/:*?"<>|
- 存储路径建议：
- 避免C盘（防止系统重装时丢失数据）
- 推荐统一管理路径（如
D:/markdownStore/
）
- 完成创建：点击"创建"按钮后自动跳转到新仓库
首次打开仓库
打开仓库的步骤只需要1步：
单击 “打开”按钮，选择目标文件夹，即可将这个文件夹作为一个新的仓库打开。
首次打开仓库
打开仓库的步骤只需要1步：
单击“打开”按钮，选择目标文件夹，即可将这个文件夹作为一个新的仓库打开。
仓库切换技巧
[! note]- 管理仓库建议（来自本文作者的使用经验）
理论上，任意一个文件夹都可作为Obsidian的一个仓库打开。
你甚至可以打开一个已经存在的仓库中的任意一个文件夹，作为你的新的仓库。
也就是说，你可以创建一个嵌套的仓库。
推荐创建一个总仓库，然后逐级管理一些小的仓库，
这样做的好处是：
- 可以分情况部署插件以及定制化的设置
- 可以统一查看文件与文件之间的关系
- 可以只为数学库中部署LaTeX Math插件，方便编写数学公式。
- 可以只在项目笔记库中部署AI插件，方便学习，记录开发中学到的知识
比如笔者的仓库结构： - honlnk
- 项目笔记
- 项目1 笔记
- 项目2 笔记
- 博客
- Obsidian基本使用文档
- 。。。
- 英语
- 语法
- 阅读
- 数学
- 错题
- 笔记
- 快速访问入口：左下角仓库名称（始终显示当前仓库名）
- 管理面板入口：点击仓库名称 → 选择"管理仓库"
- 多仓库协作：支持同时打开多个仓库窗口
基本操作
左侧面板基本操作
以上五个控件分别为：
- 收起 | 展开 左侧面板
- 文件列表：文件树，显示所有的文件
- 搜索：在库中全局搜索文件内容。
- 书签：没用过这个 嘿嘿 😆
- 标签：也没用过😆
- 语法：
#标签内容
### 这是一个二级标题 #二级标题的标签
内容1
内容2
内容3 #内容3的标签
- 这个控件在默认的设置中可能是在右侧边栏中，因个人喜好，将其移至左侧。
移动方法：鼠标单击拖动即可完成移动
右侧面板基本操作
以上四个控件分别为：
1.
收起 | 展开右侧面板
2.
反向链接：
- 显示所有引用当前文档的位置
- 支持快速跳转到引用点
- 出向链接：
- 列出当前文档内的所有链接
- 显示链接目标
- 文档大纲：
- 自动生成标题导航
- 支持点击跳转到对应章节
文件列表面板基本操作
以上五个控件分别为：
- 新建笔记：
- 新增一个Markdown文件
- 默认快捷键：
Ctrl+N
，可在设置中修改此设置 - 默认存储位置为文件根目录，可在设置中修改此设置。推荐将其设置为：存储在当前文件所在文件夹
设置
选项
文件与链接
新建笔记的存放位置
，在右边的选项卡中选择
当前文件所在的文件夹
。 - 其他操作：在文件夹处右击鼠标（如果是移动端，则长按），选择
新建笔记
- 新建文件夹：
与新建笔记类似，在根目录下创建一个文件夹，不过似乎不能进行设置。 - 排序：
对Obsidian仓库中的文件进行默认排序，默认：文件名（A-Z）。 - 自动显示文件（Auto-reveal current file）：
当启用该功能后，在切换不同笔记时，文件列表会自动跟随显示当前文件位置，避免手动在文件树中寻找当前文件。
推荐启用此选项 - 全部折叠|全部展开
左侧快捷菜单基本操作
以上6个控件分别为：
- 打开快速切换
- 默认快捷键：
Ctrl + O - 在“快速切换面板” 可以不通过文件树列表，跳转切换文件，MacOS用户可能非常喜欢。
- 查看关系图片
- 默认快捷键：
Ctrl + G
- 新建白板
- 打开/创建今天的笔记
- 插入模板
- 可在设置中设置模板的模板位置、日期格式、时间格式
- 打开命令面板：
- 默认快捷键：
Ctrl + P - 在“命令面板”中可以直接输入命令，对文档进行操作，MacOS用户可能非常喜欢。
进阶设置
[! TIP] 提示
以下设置，均根据本文笔者的使用习惯提供建议，如果你不想接受建议，这一章可以跳过 🐒
编辑器设置
拼写检查
设置 > 选项 > 编辑器 > 行为 > 拼写检查语言，添加你需要检查的语言，比如：
English
、
English（Australia）
Vim模式
[! ERROR] 警告
没有Vim使用经验的用户不要轻易尝试，除非你有学习Vim的计划
熟悉使用Vim编辑器的，还可以在设置中打开Vim模式，Obsidian已经支持了Vim的操作
设置 > 选项 > 编辑器 > 高级 > Vim 模式，打开开关
文件与链接
确认删除提示
删除文件时，一般会有一个确认删除的弹框，如果讨厌这个弹框，可以考虑将其关闭。
推荐选择默认，不关闭。以防止误删除
设置 > 选项 > 文件与链接 > 确认删除提示。
删除文件设置
如果是非Windows操作系统，推荐将其设置为：
移至软件回收站（.trash文件夹)
Windows用户任意
设置 > 选项 > 文件与链接 > 删除文件设置。在右边的选项卡中选择 ”`移至软件回收站（.trash文件夹)“
链接相关设置
1.
禁用Wiki链接格式（非标准语法）
- 设置路径：设置 > 文件与链接 > 关闭「Wiki链接」开关
- 原因：增强Markdown兼容性
- 内部链接格式规范
- 修改为：
基于当前笔记的相对路径 - 设置路径：设置 > 文件与链接 > 内部链接类型
- 优势：避免文件名冲突，提升可移植性
- 自动更新链接机制
- 开启前提：需先设置相对路径格式，避免误修改。
- 设置路径：设置 > 文件与链接 > 开启「始终更新内部链接」
- 作用：自动同步链接与文件变动
- 附件存储策略
- 设置路径：设置 > 文件与链接 > 默认存放路径
- 选择「当前文件所在文件夹下指定子文件夹」
- 子文件夹建议动态命名（如：
image
）
- 总结
- 关闭Wiki链接
- 设置相对路径格式
- 开启链接自动更新
- 配置动态附件子文件夹
新建笔记存放位置
[! WARNING] 提示
- 就文档成文日期来看（2025年2月25日），新建白板以及新建文件夹，是不可以设置默认路径的，默认都是存储在根目录下。
- 但是可以通过在文件夹处右击 选择新建的方式 在指定的文件夹下创建新的文件夹或者白板
设置 >选项 > 文件与链接 > 新建笔记的存放位置，在右边的选项卡中选择”当前文件所在的文件夹“。
检测所有类型文件
如果你有在Obsidian中，查看Obsidian默认不支持的，文本文件格式的需求。
比如你想临时在Obsidian中修改一个Python文件，你可以将这个选项打开。即可查看修改这个文件
设置 > 选项 > 文件与链接 > 检测所有类型文件，打开开关。
核心插件
斜杠命令
斜杠命令对于一些不懂Markdown语法的小白来说是非常友好的插件，可以直接以斜杠开头，输入命令，即可完成一些设置
比如想插入一个链接：直接在文本中输入
/链接
，你就可以得到这样一个下拉列表，选择你想插入的链接类型即可。
快捷键
设置 > 选项 > 快捷键
关于快捷键，用户可以根据自己的喜好设置快捷键，对于笔者而言，更喜欢与后文中要讲到的插件，一起使用。
比如：我有一个Emoji插件，如果我想添加一个笑脸😀，我有很多种操作可以选择
- 使用前文中提到的斜杠命令 输入
/emoji
，我就可以得到一个下拉列表，选择插件选项，即可打开一个选择表情的对话框 - 打开"命令面板"，在搜索框中输入Emoji，然后打开对话框
- 自定义一个快捷键，比如：
Ctrl + E
如果
Ctrl + E
已经有指定的指令，我会判断这个指令重不重要，如果不重要，我会毫不犹豫的将其替换为打开Emoji的插件。