obsidian基本使用文档

Honlnk

已于 2025-02-26 19:48:38 修改

阅读量1.4k

点赞数 17

分类专栏： Obsidian 文章标签：笔记

于 2025-02-25 23:30:24 首次发布

本文链接：https://blog.csdn.net/hongying_18/article/details/145865398

版权

Obsidian 专栏收录该内容

2 篇文章

订阅专栏

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. 有序`
链接	`[显示文本](url)`
图片	`![描述](路径)`
代码块	``` [语言名] 代码 ```
行内代码块	` 代码 `
强调	`粗体` `斜体`
引用	`> 引用内容`
分割线	三个及以上`---`或`***`
数学公式块	$$ 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的标签
```
- 这个控件在默认的设置中可能是在右侧边栏中，因个人喜好，将其移至左侧。
  移动方法：鼠标单击拖动即可完成移动

右侧面板基本操作

在这里插入图片描述
以上四个控件分别为：

收起 | 展开右侧面板
反向链接：
- 显示所有引用当前文档的位置
- 支持快速跳转到引用点
出向链接：
- 列出当前文档内的所有链接
- 显示链接目标
文档大纲：
- 自动生成标题导航
- 支持点击跳转到对应章节

文件列表面板基本操作

在这里插入图片描述
以上五个控件分别为：

新建笔记：
- 新增一个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文件夹)“

链接相关设置

禁用Wiki链接格式（非标准语法）
- 设置路径：设置 > 文件与链接 > 关闭「Wiki链接」开关
- 原因：增强Markdown兼容性
内部链接格式规范
- 修改为：基于当前笔记的相对路径
- 设置路径：设置 > 文件与链接 > 内部链接类型
- 优势：避免文件名冲突，提升可移植性
自动更新链接机制
- 开启前提：需先设置相对路径格式，避免误修改。
- 设置路径：设置 > 文件与链接 > 开启「始终更新内部链接」
- 作用：自动同步链接与文件变动
附件存储策略
- 设置路径：设置 > 文件与链接 > 默认存放路径
- 选择「当前文件所在文件夹下指定子文件夹」
- 子文件夹建议动态命名（如：image）
总结
1. 关闭Wiki链接
2. 设置相对路径格式
3. 开启链接自动更新
4. 配置动态附件子文件夹

新建笔记存放位置

[! WARNING] 提示

就文档成文日期来看（2025年2月25日），新建白板以及新建文件夹，是不可以设置默认路径的，默认都是存储在根目录下。
但是可以通过在文件夹处右击选择新建的方式在指定的文件夹下创建新的文件夹或者白板

设置 >选项 > 文件与链接 > 新建笔记的存放位置，在右边的选项卡中选择”当前文件所在的文件夹“。

检测所有类型文件

如果你有在Obsidian中，查看Obsidian默认不支持的，文本文件格式的需求。
比如你想临时在Obsidian中修改一个Python文件，你可以将这个选项打开。即可查看修改这个文件
设置 > 选项 > 文件与链接 > 检测所有类型文件，打开开关。

核心插件

斜杠命令

斜杠命令对于一些不懂Markdown语法的小白来说是非常友好的插件，可以直接以斜杠开头，输入命令，即可完成一些设置
比如想插入一个链接：直接在文本中输入 /链接，你就可以得到这样一个下拉列表，选择你想插入的链接类型即可。
在这里插入图片描述

快捷键

设置 > 选项 > 快捷键

关于快捷键，用户可以根据自己的喜好设置快捷键，对于笔者而言，更喜欢与后文中要讲到的插件，一起使用。
比如：我有一个Emoji插件，如果我想添加一个笑脸😀，我有很多种操作可以选择

使用前文中提到的斜杠命令输入 /emoji，我就可以得到一个下拉列表，选择插件选项，即可打开一个选择表情的对话框
打开"命令面板"，在搜索框中输入Emoji，然后打开对话框
自定义一个快捷键，比如：Ctrl + E
如果Ctrl + E 已经有指定的指令，我会判断这个指令重不重要，如果不重要，我会毫不犹豫的将其替换为打开Emoji的插件。