Obsidian 零基础完整教程

博主： admin
发布时间：2026 年 01 月 17 日
2 次浏览
暂无评论
6712字数
分类： obsidian 学习笔记笔记工具 Markdown AI集成

Obsidian 零基础完整教程

一、概述

1. 简介

A. 是什么

Obsidian 是一款基于本地 Markdown 文件的双向链接笔记工具，将知识管理与文本编辑完美结合。所有笔记以纯文本格式存储，用户拥有完全的数据控制权。

B. 为什么选择 Obsidian

在尝试过众多笔记工具后，选择 Obsidian 基于以下核心优势：

数据完全自主可控，无厂商锁定风险
界面流畅无卡顿，支持完全离线使用
丰富的插件生态，可自由定制功能
完美支持 AI 工具集成，提升知识管理效率

C. 学完能做什么

使用 Markdown 语法编写结构化笔记
通过双向链接构建个人知识图谱
集成 AI 工具实现自动化笔记管理
利用插件扩展打造个性化知识系统

2. 前置知识

A. 必备技能

基本电脑操作能力
文件管理基础知识

B. 推荐知识

Markdown 基础语法（教程中会详细讲解）
Git 基本操作（用于云端同步）

二、环境准备

1. 系统要求

Obsidian 支持以下平台：

Windows 10/11
macOS 10.15+
Linux（主流发行版）
iOS 和 Android（移动端）

2. 下载安装

A. 访问官网

打开 https://obsidian.md/，根据系统下载对应版本。

B. 安装步骤

下载安装包
运行安装程序
完成安装并启动 Obsidian

3. 验证安装

启动 Obsidian 后，会提示创建或打开笔记仓库。

三、核心概念

1. 基本术语

仓库（Vault）：存储所有笔记的文件夹
Markdown：轻量级标记语言，用于格式化文本
双向链接：笔记间的智能引用机制
插件：扩展 Obsidian 功能的组件
知识图谱：可视化展示笔记关系的网络图

2. 工作原理

graph LR
    A[Markdown 文件] --> B[Obsidian 核心]
    B --> C[双向链接]
    B --> D[插件系统]
    B --> E[知识图谱]
    C --> E
    D --> E
    F[AI 工具] --> B

mermaid

Obsidian 工作原理

3. 架构图

Obsidian 采用本地优先架构，数据存储在本地文件系统中，插件系统提供扩展能力，双向链接机制构建知识网络。

四、快速上手

1. 创建笔记仓库

A. 准备 GitHub 仓库

注册 GitHub 账号（如没有）
创建新仓库：点击 New Repository
在本地找个文件夹，执行以下命令克隆仓库：
```
git clone 仓库链接
```

B. 配置 .gitignore

在仓库根目录创建 .gitignore 文件，防止上传不必要的配置文件：

.obsidian/workspace.json
.obsidian/workspace-mobile.json

C. 在 Obsidian 中打开仓库

启动 Obsidian
打开刚刚克隆下来的文件夹
创建第一篇笔记

2. 配置 Git 同步

A. 安装 Git 插件

点击第三方插件
关闭安全模式
点击浏览，搜索 git
下载并安装第一个插件

B. 配置自动同步

在插件选项中配置更新时间
打开自动同步按钮
修改后右侧会显示 pull 提示

3. 配置图片管理

A. 安装 Custom attachment 插件

在插件市场搜索 Custom attachment 并安装启用。

B. 配置图片路径

点击选项进行配置

设置 Markdown URL 格式为：

assets/${noteFileName}/${generatedAttachmentFileName}

在文件与链接中配置相关选项

C. 使用图片

将图片复制到笔记中，路径会自动生成。可通过修改 [] 内的数字调整图片尺寸。

五、Markdown 语法基础

Markdown 是一种轻量级标记语言，在 Obsidian 中用于排版笔记内容。

1. 标题分级

使用 # 符号创建不同级别的标题，# 的数量决定标题级别：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题

2. 文本格式化

A. 加粗文本

使用两个星号包裹文字：

**这是加粗文字**

B. 斜体文本

使用一个星号包裹文字：

*这是斜体文字*

C. 高亮文本

使用两个等号包裹文字：

==这是高亮文字==

D. 删除线

使用两个波浪号包裹文字：

~~这是删除线文字~~

3. 列表与任务管理

A. 无序列表

使用 - 或 * 开头：

- 列表项1
- 列表项2
  - 子列表项

B. 有序列表

使用数字加点号开头：

1. 第一项
2. 第二项
3. 第三项

C. 任务列表

使用 - [ ] 创建待办事项：

- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 待处理的任务

4. 代码块

A. 行内代码

使用反引号包裹：

这是 `代码示例` 的效果

B. 代码块

使用三个反引号包裹，可指定语言实现语法高亮：

```python
def hello_world():
    print("Hello, World!")
```

5. 表格

使用竖线和横线创建表格：

| 列标题1 | 列标题2 | 列标题3 |
|---------|---------|---------|
| 内容1   | 内容2   | 内容3   |
| 内容4   | 内容5   | 内容6   |

6. 链接与图片

A. 链接

[显示文字](https://example.com)

B. 图片

![图片描述](图片链接)

六、双向链接与知识图谱

双向链接是 Obsidian 最核心的特性之一，它让笔记之间建立起有机的联系，构建个人知识网络。

1. 什么是双向链接

双向链接是一种高级的引用方式：

当你在笔记 A 中引用笔记 B 时
笔记 B 会自动显示被笔记 A 引用
形成双向的关联关系

这种机制让知识点自然串联，而不是孤立存在。

2. 如何使用双向链接

A. 基本语法

使用双中括号 [[]] 创建链接：

[[笔记名称]]

B. 引用文件示例

我本月写了一个教程 [[Obsidian零基础教程]]

C. 链接到标题

[[笔记名称#标题名称]]
例如：[[Obsidian教程#安装步骤]]

D. 自定义显示文字

[[实际笔记名称|显示的文字]]
例如：[[Markdown语法|MD语法]]

E. 嵌入笔记内容

使用 ![[]] 在当前笔记中显示被引用笔记的内容：

![[笔记名称]]

3. 创建双向链接的方法

A. 方法1：拖拽创建

在编辑模式下，直接从左侧文件列表拖拽笔记到编辑区
自动生成双向链接语法

B. 方法2：输入创建

输入 [[ 后，Obsidian 会自动提示现有笔记
选择或继续输入笔记名称
如果笔记不存在，点击链接会自动创建

C. 方法3：反向链接面板

每篇笔记右侧会显示反向链接面板
列出所有引用当前笔记的其他笔记
点击可快速跳转

4. 标签系统

A. 创建标签

#标签名称
#技术/编程/Python

B. 标签的作用

快速分类和检索笔记
在图谱中以不同颜色显示
支持嵌套标签（用 / 分隔）

5. 知识图谱

A. 打开图谱

点击左侧边栏的关系图谱图标
或使用快捷键 Ctrl/Cmd + G

B. 图谱功能

节点：每个节点代表一篇笔记
连线：连线表示笔记之间的链接关系
颜色：可根据标签或文件夹设置不同颜色
筛选：可以筛选特定标签或文件夹的笔记

C. 图谱操作

拖拽节点调整布局
点击节点打开对应笔记
放大缩小查看整体结构
使用筛选器关注特定主题

D. 实用技巧

在笔记中建立知识网络：

[[核心概念]] → [[具体应用]] → [[实践案例]]

使用标签分类：#项目管理 #个人成长 #技术学习

七、AI 结合 Obsidian 使用方式

Obsidian 的纯文本架构天然适配 AI 工具，可以极大提升笔记管理效率。

1. AI 自动化笔记管理

通过 AI 工具（如 Gemini CLI）可以实现：

A. 自动创建笔记

AI 根据指令自动生成笔记文件和文件夹结构。

B. 生成内容大纲

输入主题，AI 自动生成详细的文章大纲和框架。

C. 批量整理笔记

AI 可以批量处理零散内容，整理为结构化的笔记。

D. 示例操作

# 使用 claude code 生成笔记
claude "帮我基于晴天写一首诗放到随笔里面"

AI 会自动创建文件，然后写入到随笔里。

2. Markdown 文件批处理

AI 可以执行以下批量操作：

重命名笔记时自动更新所有附件路径
将零散的字幕或 OCR 内容整理为连贯段落
自动添加 YAML 元数据（标题、日期、标签等）
批量格式化代码块和表格

3. 智能内容生成

A. 内容摘要

AI 指令：总结这篇文章的核心要点，用列表形式呈现
输出：自动生成带复选框的 Markdown 段落

B. 智能关联

AI 通过分析笔记内容，自动建立双向链接
在关系图谱中智能标注相关主题
推荐相关笔记和参考资料

4. 常用 AI 工具集成

A. Gemini CLI

执行自然语言指令处理笔记
支持批量操作和自动化脚本
输出标准 Markdown 格式

B. Claude Code

分析代码片段并插入注释
通过代码块与 AI 交互
生成技术文档和 API 说明

C. 集成方式

安装对应的 AI 工具 CLI 版本
在 Obsidian 中通过命令行或插件调用
设置自动化工作流，如每日自动总结笔记

八、插件推荐

Obsidian 的强大之处在于其丰富的插件生态。插件分为核心插件（官方自带）和社区插件（第三方开发）。

1. 必备核心插件

A. 大纲（Outline）

实时显示当前笔记的标题结构
点击标题快速跳转到对应位置
便于查看和管理长文档结构

B. 工作台（Workspaces）

保存不同的工作布局
一键切换学习、写作、项目管理等场景
每个工作台可包含不同的笔记和面板组合

C. 录音机（Audio Recorder）

在笔记中直接录音
录音文件自动保存在库文件中
适合记录会议、讲座等场景

D. 模板（Templates）

创建笔记模板，避免重复输入
支持日期、时间等动态变量
适合日记、会议记录等固定格式笔记

E. 设置方法

1. 创建模板文件夹（如 Templates）
2. 在设置中指定模板文件夹位置
3. 创建模板文件，使用 {{date}} 等变量
4. 使用时点击插入模板

2. 热门社区插件

A. Calendar

在侧边栏显示日历视图
点击日期创建或打开日记笔记
可视化查看笔记创建时间

B. Advanced Tables

快速创建和编辑 Markdown 表格
自动对齐表格列
支持表格排序和公式计算

C. Templater

比核心模板插件更强大
支持 JavaScript 脚本
可创建动态模板和自动化工作流

示例模板

---
title: <% tp.file.title %>
date: <% tp.file.creation_date("YYYY-MM-DD HH:mm:ss") %>
tags:
---

D. Dataview

将笔记当作数据库查询
生成动态内容列表
适合任务管理、项目追踪

示例查询

# 查询所有未完成任务
TASK WHERE !completed

E. Excalidraw

在 Obsidian 中绘制手绘风格图表
支持流程图、思维导图
可嵌入到笔记中

F. Auto Link Title

粘贴 URL 时自动获取网页标题
生成格式化的 Markdown 链接
节省手动输入标题的时间

3. 插件使用建议

A. 循序渐进

不要一次性安装太多插件，先熟悉基本功能。

B. 按需安装

根据实际使用场景选择插件。

C. 定期清理

卸载不常用的插件，保持系统流畅。

D. 查看文档

每个插件都有说明文档，遇到问题先查阅文档。

E. 社区交流

加入 Obsidian 中文社区，获取插件推荐和使用技巧。

4. 插件配置技巧

A. 设置快捷键

打开设置 → 快捷键
搜索插件命令
设置自定义快捷键

九、进阶技巧

1. 工作流优化

建立每日笔记习惯
使用模板加速创作
定期整理和归档

2. 知识管理原则

以自己的话语记录
建立知识间的连接
持续迭代和更新

3. 备份与同步

使用 Git 进行版本控制
定期备份到云端
多设备同步配置

十、常见问题

1. 安装问题

下载失败：检查网络连接，尝试使用镜像源
无法启动：检查系统兼容性

2. 配置问题

插件无法安装：检查是否关闭了安全模式
同步失败：检查 Git 配置和网络连接

3. 使用问题

图片无法显示：检查图片路径配置
链接失效：检查笔记名称是否正确

参考资料

最后修改：2026 年 01 月 17 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址