Obsidian - 完整学习教程

**教程级别：** 从零到一
**预计学习时间：** 8-12 小时
**前置知识：** 基本的 Markdown 语法（标题、列表、链接、代码块等），了解 YAML 格式有助于学习 Properties 功能

Obsidian - 完整学习教程

教程级别： 从零到一 预计学习时间： 8-12 小时 前置知识： 基本的 Markdown 语法（标题、列表、链接、代码块等），了解 YAML 格式有助于学习 Properties 功能

环境搭建指南

系统要求

  • 操作系统：Windows 10+、macOS 12+、Linux（主流发行版）、iOS 15+、Android 10+
  • 磁盘空间：约 200MB（应用本身）+ 笔记存储空间
  • 依赖版本：无需额外运行时环境，Obsidian 为独立安装包

安装步骤

桌面端（Windows/macOS/Linux）：

# 方式一：从官网下载安装包
# 访问 https://obsidian.md/download 下载对应平台的安装包
# Windows: Obsidian.X.X.X.exe
# macOS: Obsidian.dmg
# Linux: Obsidian.AppImage 或 .deb/.rpm

# 方式二（macOS，使用 Homebrew Cask）
brew install --cask obsidian

# 方式三（Linux，使用 Snap）
sudo snap install obsidian --classic

# 方式四（Linux，使用 Flatpak）
flatpak install flathub md.obsidian.Obsidian

移动端： - iOS：在 App Store 搜索 "Obsidian" 安装 - Android：在 Google Play 搜索 "Obsidian" 安装，或从官网下载 APK

验证安装

# 桌面端安装后，在应用程序列表中找到 Obsidian 图标
# 启动后会看到欢迎页面，提示"创建新库"或"打开已有库"

# 验证步骤：
# 1. 启动 Obsidian
# 2. 点击"创建新库"
# 3. 选择一个空文件夹作为 Vault 位置（例如 ~/ObsidianTutorial）
# 4. 成功进入后，左侧文件列表为空，右侧显示欢迎页面

第一部分：入门篇

1.1 理解 Vault（知识库）和基本笔记操作

概念讲解：

Vault 是 Obsidian 中的核心概念，对应文件系统中的一个文件夹。Vault 内的所有 Markdown 文件和子文件夹构成一个完整的知识库。链接解析、搜索、图谱等功能都在 Vault 范围内运行。你可以创建多个 Vault 来隔离不同领域的知识。

Obsidian 的笔记就是标准的 Markdown 文件（.md）。你可以使用任何文本编辑器打开和编辑这些文件，Obsidian 会自动检测文件变化并更新索引。

操作示例：

<!-- 在 Obsidian 中创建第一篇笔记 -->
<!-- 点击左侧文件列表上方的"新建笔记"按钮（或按 Ctrl/Cmd + N） -->
<!-- 将笔记命名为 "我的第一篇笔记" -->

# 我的第一篇笔记

欢迎使用 Obsidian！这是一篇 Markdown 笔记。

## 基本格式

### 文字格式
- **加粗文字** 使用双星号
- *斜体文字* 使用单星号
- ~~删除线~~ 使用双波浪号
- `行内代码` 使用反引号

### 列表
1. 有序列表第一项
2. 有序列表第二项
3. 有序列表第三项

- 无序列表第一项
- 无序列表第二项
  - 嵌套列表项

### 代码块
```python
def hello():
    print("Hello from Obsidian!")

引用

这是一段引用文字。 Markdown 让笔记结构清晰、格式统一。

链接

表格

功能 快捷键 说明
新建笔记 Ctrl/Cmd + N 创建新的 Markdown 文件
快速切换 Ctrl/Cmd + O 在笔记间快速跳转
搜索 Ctrl/Cmd + Shift + F 全库全文搜索
命令面板 Ctrl/Cmd + P 执行所有可用命令 

**执行结果：**

在 Obsidian 编辑器中会看到实时渲染的 Markdown 内容： - 标题显示为不同大小的加粗文字 - 加粗、斜体、删除线等格式正确渲染 - 代码块带有语法高亮 - 表格以标准表格样式显示 - 链接可点击跳转


**练习题：**
1. 创建一个名为 "日记/2026-04-13" 的笔记，使用子文件夹组织（在文件名中输入 `/` 即可自动创建子文件夹），内容包含标题、一段正文和一个列表
2. 尝试使用命令面板（Ctrl/Cmd + P）搜索并执行 "切换预览/源码模式" 命令，观察编辑器的两种显示模式

---

### 1.2 双向链接与反向链接

**概念讲解：**

双向链接（Bidirectional Links）是 Obsidian 的核心功能。当你在笔记 A 中使用 `[[笔记B]]` 链接到笔记 B 时，Obsidian 会自动在笔记 B 的"反向链接"面板中显示笔记 A 的引用。这意味着你不需要在笔记 B 中手动添加反向引用——系统自动追踪所有链接关系。

双向链接的核心价值在于**打破文件夹层级的限制**，让知识以网状结构组织。你不再需要为"这篇笔记应该放在哪个文件夹"而纠结，只需通过链接自然地建立笔记间的关联。

**操作示例：**

```markdown
<!-- 创建笔记 "项目想法.md" -->
# 项目想法

今天想到一个有趣的项目方向：开发一个 [[个人记账应用]]。

这个想法来源于我对 [[数据分析]] 的兴趣，以及对 [[个人财务管理]] 的需求。

## 技术方案

可能使用的技术栈：
- [[React]] 作为前端框架
- [[Node.js]] 作为后端
- 数据可视化可以参考 [[D3.js]] 的方案

<!-- 创建笔记 "个人记账应用.md" -->
# 个人记账应用

一个帮助个人管理日常收支的 Web 应用。

## 功能规划
1. 收入/支出记录
2. 分类统计
3. 月度报表
4. 数据可视化

## 相关笔记
- 这个项目是 [[项目想法]] 的具体落地
- 技术选型参考了 [[React]] 和 [[Node.js]]

<!-- 创建笔记 "数据分析.md" -->
# 数据分析

数据分析是从原始数据中提取有用信息的过程。

## 常用工具
- Python（Pandas、NumPy）
- R 语言
- Excel

## 相关应用
- [[个人记账应用]] 中的数据可视化功能需要数据分析技术

执行结果：

1. 打开 "个人记账应用.md" 时，右侧"反向链接"面板显示：
   - 被引用于：项目想法

2. 打开 "数据分析.md" 时，右侧"反向链接"面板显示：
   - 被引用于：项目想法、个人记账应用

3. 在编辑器中输入 [[ 时，会弹出自动补全列表，显示 Vault 中所有笔记

4. 按住 Ctrl/Cmd 并点击 [[链接]]，可以跳转到对应笔记

练习题： 1. 创建 3 篇主题相关的笔记（如 "学习计划"、"读书笔记"、"Python 学习"），在每篇笔记中使用 [[双括号]] 链接到其他笔记，然后打开其中一篇查看"反向链接"面板 2. 尝试使用"未链接提及"功能（在反向链接面板的"未链接提及"标签页），发现潜在的关联笔记

第二部分：进阶篇

2.1 Properties（元数据/属性）

详细讲解：

Properties（属性）是 Obsidian 为笔记添加结构化元数据的机制，以 YAML Frontmatter 格式存储在 Markdown 文件开头（--- 分隔符之间）。Properties 支持多种数据类型：文本（Text）、列表（List）、日期（Date）、复选框（Checkbox）、数字（Number）等。

Properties 在进阶工作流中扮演重要角色：配合搜索功能按属性筛选笔记，配合 Dataview 插件进行数据库式查询，配合 Templater 插件自动填充元数据。

代码示例：

---
title: React 学习笔记
date: 2026-04-13
tags:
  - 前端开发
  - React
  - JavaScript
aliases:
  - React笔记
  - React基础
status: in-progress
priority: 2
rating: 4
cover: "[[react-logo.png]]"
---

# React 学习笔记

## 学习目标
1. 掌握 React 基本概念
2. 理解组件化开发思想
3. 实践 Hooks API

## 相关笔记
- [[JavaScript 基础]]
- [[前端框架对比]]

<!-- 使用 Obsidian 的属性搜索功能 -->
<!-- 在搜索栏中输入： -->
[tag: 前端开发]
<!-- 搜索所有带有"前端开发"标签的笔记 -->

[status: in-progress]
<!-- 搜索所有状态为 "in-progress" 的笔记 -->

[tag: React] [priority: 2]
<!-- 组合搜索：带有 React 标签且优先级为 2 的笔记 -->

执行结果：

1. 在 Obsidian 的"搜索"面板中输入 [tag: 前端开发]
   → 显示所有包含 "前端开发" 标签的笔记列表

2. 输入 [status: in-progress]
   → 显示所有 status 属性为 "in-progress" 的笔记

3. 笔记标题上方显示 Properties 面板，以可视化方式展示元数据
   → 可直接点击编辑属性值

注意事项： - YAML Frontmatter 中的缩进必须使用空格（不能使用 Tab），否则会导致解析错误 - tags 属性支持两种格式：列表形式（- tag1）和逗号分隔形式（tag1, tag2），推荐使用列表形式 - aliases（别名）允许为笔记设置多个可搜索的名称，在 [[ 自动补全时别名也会出现 - 如果 YAML 语法有误，Obsidian 会在笔记顶部显示错误提示

练习题： 1. 为之前创建的 3 篇笔记添加 Properties，包括 tags、date、status 属性，然后使用搜索功能按属性筛选 2. 创建一个笔记模板（使用 Obsidian 核心插件"模板"或手动创建），包含常用的 Properties 字段，后续新建笔记时复用

2.2 社区插件安装与配置

详细讲解：

社区插件是 Obsidian 生态的核心优势。通过安装社区插件，你可以将 Obsidian 从一个简单的 Markdown 编辑器扩展为功能丰富的知识管理平台。以下是三个最常用且强烈推荐的插件：

  1. Dataview：将 Obsidian 变成一个面向笔记的数据库，使用类 SQL 查询语法动态生成笔记列表和表格
  2. Templater：高级模板引擎，支持变量、函数、日期计算和自动执行脚本
  3. Calendar：日历视图插件，方便导航日记和按日期浏览笔记

操作示例：

# 安装社区插件的步骤：

# 步骤一：启用社区插件功能
# 1. 打开"设置"（Ctrl/Cmd + ,）
# 2. 进入"第三方插件"（Community plugins）页面
# 3. 点击"安全模式"开关，关闭安全模式
# 4. 点击"浏览"按钮，打开插件市场

# 步骤二：搜索并安装插件
# 在插件市场中搜索插件名称：
# - 搜索 "Dataview" → 点击"安装" → 点击"启用"
# - 搜索 "Templater" → 点击"安装" → 点击"启用"
# - 搜索 "Calendar" → 点击"安装" → 点击"启用"

<!-- Dataview 插件使用示例 -->
<!-- 在任意笔记中输入以下 Dataview 查询代码块 -->

```dataview
TABLE status, priority, date
FROM "项目想法"
WHERE status = "in-progress"
SORT priority ASC

LIST
FROM #前端开发
WHERE date >= date(2026-01-01)
SORT date DESC


```markdown
<!-- Templater 插件使用示例 -->
<!-- 创建一个模板文件（例如 "Templates/日记模板.md"） -->

---
title: "{{date:YYYY-MM-DD}} 日记"
date: "{{date:YYYY-MM-DD}}"
tags:
  - 日记
  - daily-note
---

# {{date:YYYY年MM月DD日}} 日记

## 今日待办
- [ ]

## 学习记录
-

## 灵感与想法
-

## 反思
-

---
<!-- Templater 变量说明：
{{date:YYYY-MM-DD}}   → 自动填充当前日期，格式为 2026-04-13
{{date:YYYY年MM月DD日}} → 自动填充中文格式日期
{{time:HH:mm}}        → 自动填充当前时间
-->

执行结果：

Dataview 查询结果（TABLE 格式）：
| 文件名          | status      | priority | date       |
|-----------------|-------------|----------|------------|
| 个人记账应用    | in-progress | 2        | 2026-04-13 |
| React 学习笔记  | in-progress | 2        | 2026-04-10 |

Dataview 查询结果（LIST 格式）：
- React 学习笔记
- 个人记账应用

Templater 模板插入后：
标题自动变为 "2026年04月13日 日记"
date 属性自动填充为 "2026-04-13"

注意事项： - 安装社区插件需要先关闭"安全模式"。Obsidian 默认启用安全模式以保护非技术用户，关闭后会提示风险确认 - 部分插件需要额外配置才能使用（如 Dataview 需要启用 JavaScript 查询功能，Templater 需要指定模板文件夹） - 插件之间可能存在冲突。如果安装新插件后出现异常，尝试逐个禁用插件排查 - 移动端插件兼容性有限，部分插件在"manifest.json"中标记了 isDesktopOnly: true，这些插件无法在移动端使用

练习题： 1. 安装 Dataview 插件，创建一个包含 Properties 的笔记集合（至少 5 篇，带有 tags、status、date 属性），编写一个 Dataview 查询按状态分组显示笔记 2. 安装 Templater 插件，创建一个笔记模板，配置 Templater 的快捷键（如 Ctrl/Cmd + T），使用模板快速创建新笔记

第三部分：高级篇

3.1 Canvas（画布）与视觉化思维

Canvas 是 Obsidian 内置的无限画布功能，支持自由放置笔记卡片、图片、PDF、网页嵌入等元素，通过箭头连接表达逻辑关系。

操作示例：

# 创建 Canvas 的步骤：
# 1. 在文件列表中右键 → "新建画布"
# 2. 或使用命令面板（Ctrl/Cmd + P）→ 搜索 "Canvas: 新建画布"

# Canvas 中的操作：
# - 双击空白区域：创建新的文字卡片
# - 拖拽左侧文件列表中的笔记到画布：嵌入已有笔记
# - 从卡片边缘拖拽：创建箭头连接
# - 右键卡片 → "添加嵌入网页"：嵌入网页（如 https://obsidian.md）
# - 选中多个卡片 → 右键 → "对齐"：批量对齐卡片

# Canvas 数据存储：
# Canvas 数据以 .canvas 格式存储在 Vault 中
# 本质是 JSON 文件，可被其他工具解析

<!-- 典型 Canvas 使用场景：项目规划 -->

<!-- 步骤：
1. 创建 "项目规划.canvas"
2. 从文件列表拖入 "项目想法.md" 笔记卡片
3. 添加文字卡片："技术选型"、"时间规划"、"团队分工"
4. 用箭头连接 "项目想法" → "技术选型" → "时间规划"
5. 嵌入参考网页（如 React 官方文档）
-->

注意事项： - Canvas 文件（.canvas）不会出现在 Graph View 中，因为它们不是 Markdown 文件 - 大型 Canvas（超过 100 个卡片）可能影响性能 - Canvas 功能在移动端体验有限，建议在桌面端使用

3.2 性能优化与大型 Vault 管理

  • 优化策略一：控制插件数量 — 只安装和启用真正需要的插件。每个活跃插件都会增加 Obsidian 的内存占用和启动时间。建议活跃插件不超过 20 个。

  • 优化策略二：使用子文件夹组织 — 虽然 Obsidian 的链接功能不依赖文件夹结构，但合理的文件夹组织有助于文件管理。建议按领域或项目创建顶级文件夹，避免 Vault 根目录下有过多文件。

推荐的 Vault 文件夹结构：
MyVault/
├── 00-收件箱/          # 快速捕获的临时笔记
├── 01-项目/            # 活跃项目笔记
│   ├── 记账应用/
│   └── 博客重构/
├── 02-领域/            # 持续关注的领域知识
│   ├── 前端开发/
│   ├── 数据分析/
│   └── 产品设计/
├── 03-资源/            # 参考资料
│   ├── 读书笔记/
│   └── 课程笔记/
├── 04-归档/            # 已完成的项目
├── Templates/          # Templater 模板
├── Attachments/        # 附件（图片、PDF等）
└── .obsidian/          # Obsidian 配置（自动生成，勿手动修改）
  • 优化策略三：定期维护 — 使用 Dataview 查询找出空笔记、孤立笔记（无链接的笔记）和未完成的待办事项，定期清理。
<!-- 查找所有未完成的待办事项 -->
TASK
WHERE !completed
SORT file.mtime DESC

<!-- 查找最近 30 天未修改的笔记 -->
LIST
WHERE file.mtime < date(today) - dur(30 days)
SORT file.mtime ASC

3.3 最佳实践

  1. 每日笔记（Daily Notes）工作流 — 每天创建一篇日记笔记，记录当天的工作、学习和想法。配合 Templater 模板和 Calendar 插件，形成规律的知识积累习惯。在日记中使用 [[链接]] 将临时想法与永久笔记关联。

  2. 渐进式整理（Progressive Summarization） — 不要追求一次性写出完美的笔记。先快速捕获信息（粗略记录），后续在回顾时逐步补充链接、添加 Properties、完善结构。Obsidian 的反向链接功能让你在浏览旧笔记时自然地发现补充机会。

  3. MOC（Map of Content）索引笔记 — 为每个知识领域创建一篇索引笔记（如 "前端开发 MOC"），汇总该领域下的所有重要笔记链接。MOC 相当于知识库的"目录"，帮助导航和维护知识结构。

<!-- MOC 示例：前端开发索引 -->
# 前端开发 MOC

## 基础
- [[HTML 基础]]
- [[CSS 布局]]
- [[JavaScript 核心]]

## 框架
- [[React 学习笔记]]
- [[Vue.js 入门]]
- [[Svelte 探索]]

## 工具链
- [[Vite 配置]]
- [[ESLint 规则]]
- [[Git 工作流]]

## 性能优化
- [[前端性能指标]]
- [[懒加载策略]]
- [[CDN 部署]]

第四部分：实战项目

项目需求

构建一个个人知识管理系统（PKM），综合运用 Obsidian 的核心功能：Vault 组织、双向链接、Properties、Dataview 查询、Templater 模板和 Canvas 画布。系统需要满足以下需求：

  1. 结构化的笔记组织（文件夹 + MOC 索引）
  2. 规范的元数据管理（Properties 标签体系）
  3. 自动化的日记工作流（Templater 模板）
  4. 动态的知识库仪表盘（Dataview 查询）
  5. 项目规划的视觉化（Canvas）

项目设计

技术选型： Obsidian 核心功能 + Dataview 插件 + Templater 插件 + Calendar 插件

架构设计：

PKM-Vault/
├── 00-收件箱/           # 快速捕获
├── 01-项目/             # 活跃项目（每个项目一个子文件夹）
├── 02-领域/             # 持续学习领域
├── 03-资源/             # 参考资料
├── 04-归档/             # 完成项目
├── 05-日记/             # Daily Notes
├── Templates/           # 模板文件
│   ├── 项目模板.md
│   ├── 领域笔记模板.md
│   ├── 资源笔记模板.md
│   └── 日记模板.md
├── Attachments/         # 附件
├── Dashboard.md         # 知识库仪表盘
└── MOC.md               # 总索引

完整实现代码

步骤一：创建 Vault 和文件夹结构

# 在终端中创建 Vault 目录结构
mkdir -p ~/PKM-Vault/{00-收件箱,01-项目,02-领域,03-资源,04-归档,05-日记,Templates,Attachments}

# 启动 Obsidian，选择"打开已有库"，选择 ~/PKM-Vault 目录

步骤二：创建 Templater 模板

<!-- 文件路径：Templates/项目模板.md -->

---
title: "{{title}}"
date: "{{date:YYYY-MM-DD}}"
tags:
  - 项目
status: active
priority:
deadline:
aliases: []
---

# {{title}}

## 项目概述
<!-- 简要描述项目目标和背景 -->

## 目标
- [ ] 目标一
- [ ] 目标二
- [ ] 目标三

## 关键里程碑
| 里程碑 | 预计日期 | 状态 |
|--------|----------|------|
|        |          |      |

## 相关笔记
<!-- 使用 [[链接]] 关联相关笔记 -->

## 进展记录
### {{date:YYYY-MM-DD}}
-

<!-- 文件路径：Templates/日记模板.md -->

---
title: "{{date:YYYY-MM-DD}} 日记"
date: "{{date:YYYY-MM-DD}}"
tags:
  - 日记
mood:
---

# {{date:YYYY年MM月DD日 dddd}} 日记

## 今日任务
- [ ]

## 学习记录
<!-- 记录今天学到的知识点 -->
-

## 灵感与想法
<!-- 随时记录闪现的想法 -->
-

## 今日回顾
<!-- 一句话总结今天 -->
-

## 关联笔记
<!-- 使用 [[链接]] 关联今天的思考与已有知识 -->
-

步骤三：创建 MOC 总索引

<!-- 文件路径：MOC.md -->

# 知识库总索引

> 最后更新：{{date:YYYY-MM-DD}}

## 活跃项目
```dataview
TABLE status, priority, deadline
FROM "01-项目"
WHERE status = "active"
SORT priority ASC

知识领域

  • [[前端开发 MOC]]
  • [[数据分析 MOC]]
  • [[产品设计 MOC]]

最近更新

TABLE file.mtime AS "更新时间"
FROM ""
SORT file.mtime DESC
LIMIT 10

快速入口

  • [[今日日记]]（使用 Calendar 插件快速跳转到今天的日记）
  • [[收件箱]]（快速捕获想法）

**步骤四：创建知识库仪表盘**

```markdown
<!-- 文件路径：Dashboard.md -->

# 知识库仪表盘

## 统计概览
```dataview
TABLE length(rows) AS "笔记数量"
FROM ""
GROUP BY file.folder
SORT length(rows) DESC

进行中的项目

TABLE priority, deadline
FROM "01-项目"
WHERE status = "active"
SORT priority ASC

本周日记

LIST
FROM "05-日记"
WHERE date >= date(today) - dur(7 days)
SORT date DESC

未完成任务

TASK
FROM "01-项目"
WHERE !completed
SORT file.name ASC

最近添加的笔记

TABLE file.ctime AS "创建时间"
FROM ""
WHERE file.ctime >= date(today) - dur(7 days)
SORT file.ctime DESC

需要关注（30天未更新）

TABLE file.mtime AS "最后更新"
FROM "01-项目" OR "02-领域"
WHERE file.mtime < date(today) - dur(30 days) AND status = "active"
SORT file.mtime ASC

```

代码解析

  1. Vault 文件夹结构（知识点：Vault 组织）— 使用数字前缀（00-05）控制文件夹显示顺序，确保最重要的"收件箱"和"项目"排在最前面。"归档"文件夹用于存放已完成的项目，保持活跃区域干净。

  2. Templater 模板（知识点：Properties + Templater）— 每个模板都包含标准化的 Properties 字段（title、date、tags、status），确保所有笔记具有一致的元数据结构。Templater 变量（{{date:YYYY-MM-DD}}、{{title}}）自动填充动态内容。

  3. MOC 总索引（知识点：双向链接 + Dataview）— MOC 作为知识库的"导航首页"，通过 Dataview 查询动态展示活跃项目和最近更新的笔记，无需手动维护列表。

  4. 仪表盘（知识点：Dataview 查询 + Properties 搜索）— Dashboard 综合运用 5 个 Dataview 查询（统计概览、进行中项目、本周日记、未完成任务、需关注笔记），提供知识库的全局视图。所有查询都基于笔记的 Properties 元数据进行筛选和排序。

扩展挑战

  1. 添加 Canvas 项目看板 — 为一个活跃项目创建 Canvas 画布，将项目相关的笔记卡片拖入画布，用箭头表示任务依赖关系，嵌入参考网页（如技术文档链接）
  2. 实现自动化归档 — 使用 Dataview 查询找出所有 status: completed 的项目笔记，结合手动操作将它们移动到"04-归档"文件夹，更新 MOC 索引
  3. 构建学习路线图 — 为一个学习领域（如 "前端开发"）创建 MOC 索引笔记，按学习路径顺序组织笔记链接，使用 Properties 标记每篇笔记的 difficulty（难度）和 progress（完成进度）

第五部分：常见问题与排查指南

常见错误及解决方案

错误信息 原因 解决方案
"Failed to open" 打开 Vault 失败 Vault 文件夹路径包含特殊字符或被其他程序锁定 将 Vault 移至纯英文路径，关闭其他可能锁定文件的程序（如同步工具）
插件无法安装或加载失败 网络问题或插件与当前 Obsidian 版本不兼容 检查网络连接；在插件 GitHub 仓库查看兼容的最低版本；尝试手动安装（将插件文件夹放入 .obsidian/plugins/）
YAML Frontmatter 解析错误 YAML 语法错误（如 Tab 缩进、冒号未转义） 确保使用空格缩进，属性值中的冒号用引号包裹
搜索结果不完整 索引未及时更新 使用命令面板执行 "重建搜索索引"（Rebuild search index）
Dataview 查询无结果 Properties 字段名或值不匹配 检查 Properties 字段名的大小写和拼写是否一致；确认查询语法正确
同步冲突（Obsidian Sync） 多设备同时编辑同一笔记 在 Sync 设置中启用"版本历史"，手动选择保留哪个版本
Graph View 不显示某些链接 链接格式错误或笔记已删除 检查 [[链接]] 格式是否正确，确认目标笔记存在
移动端插件不工作 插件仅支持桌面端 检查插件 manifest.json 中的 isDesktopOnly 字段，寻找替代插件

调试技巧

  1. 使用开发者控制台 — 按 Ctrl/Cmd + Shift + I 打开开发者控制台，查看错误日志和插件调试信息。当插件行为异常时，先检查控制台是否有红色错误信息。控制台中的 Console 标签页显示 JavaScript 错误，Network 标签页显示网络请求状态。

  2. 安全模式排查法 — 当 Obsidian 出现异常时，进入"设置 → 第三方插件 → 开启安全模式"禁用所有插件。如果问题消失，说明是某个插件导致的。然后逐个重新启用插件，定位问题插件。

  3. 检查 .obsidian 配置目录 — Vault 中的 .obsidian/ 目录（隐藏目录）存储所有配置数据。如果配置损坏导致异常，可以备份该目录后删除，Obsidian 会重新生成默认配置。注意：这会丢失所有自定义设置和插件配置。

第六部分：学习路线推荐

官方文档推荐阅读顺序

  1. Obsidian 帮助文档 - 编辑与格式化 — 重点：Markdown 语法、链接语法、嵌入语法
  2. Obsidian 帮助文档 - 链接笔记 — 重点：双向链接、反向链接、未链接提及
  3. Obsidian 帮助文档 - 属性（Properties） — 重点：YAML Frontmatter、属性类型、属性搜索
  4. Obsidian 帮助文档 - 插件 — 重点：核心插件配置、社区插件安装
  5. Obsidian 插件开发文档 — 重点：API 概览、manifest.json 结构、生命周期方法（onload/onunload）

推荐进阶资源

  • 书籍： 《How to Take Smart Notes》（Sönke Ahrens 著）— 卡片盒笔记法的理论基础，帮助理解 Obsidian 背后的知识管理哲学
  • 社区资源： Obsidian 官方论坛（forum.obsidian.md）— 搜索 "workflow" 和 "showcase" 标签，学习其他用户的知识管理工作流
  • 插件开发： Obsidian Sample Plugin（GitHub: obsidianmd/obsidian-sample-plugin）— 官方插件开发模板仓库，包含完整的插件骨架代码和开发环境配置