余白

Obsidian 使用指南

简介

Obsidian 是一款强大的本地笔记和知识管理工具,基于 Markdown 文件,支持双向链接、图谱视图、插件扩展等高级功能。

核心特点

  • 本地优先:数据存储在本地文件夹
  • Markdown 格式:纯文本,永久可读
  • 双向链接:笔记名 语法
  • 图谱视图:可视化笔记关系
  • 插件生态:丰富的社区插件

基础操作

创建笔记

  • Ctrl+N:新建笔记
  • Ctrl+Shift+N:新窗口新建
  • 右键文件夹 → 新建笔记

基础语法

# 标题1
## 标题2
### 标题3

**粗体** 和 *斜体*

- 无序列表
- 项目2

1. 有序列表
2. 项目2

- [ ] 待办事项
- [x] 已完成

> 引用文本

`行内代码`

```代码块```

链接

## 内部链接
笔记名
文件夹/笔记名

## 带显示文字
笔记名|显示文字

## 外部链接
[显示文字](https://example.com)

## 图片
![[图片.png]]
![alt](https://example.com/image.png)

核心功能

1. 双向链接

  • 输入 [[ 触发自动补全
  • 链接到不存在的笔记会自动创建
  • 背链(Backlinks)面板显示引用该笔记的所有位置

2. 标签

#标签
#子标签/子标签

#工作 #重要 #2024
  • 右键标签可查看所有相关笔记
  • 支持嵌套标签

3. 搜索

  • Ctrl+P:快速切换器
  • Ctrl+Shift+F:全局搜索
  • Ctrl+O:打开笔记
  • 支持正则表达式搜索

4. 嵌入

## 嵌入笔记内容
!笔记名

## 只嵌入部分
![[笔记名#标题]]

## 嵌入图片
![[image.png]]

YAML Frontmatter

笔记开头的元数据:

---
title: 笔记标题
tags:
  - 标签1
  - 标签2
created: 2024-01-01
updated: 2024-01-15
aliases: [别名1, 别名2]
---

正文内容...

常用属性

属性说明
title笔记标题
tags标签数组
created创建时间
updated更新时间
aliases别名(搜索可用)
cssclasses自定义样式

核心插件

1. 文件恢复

  • 自动保存历史版本
  • 设置 → 关于 → 实验功能 → 启用
  • 右键笔记 → 显示本地可用版本

2. 每日笔记

  • Ctrl+N 输入日期创建
  • 设置每日笔记模板
  • 快速访问日历年历

3. 模板

  • 创建可复用的笔记模板
  • 设置模板快捷键
  • 支持变量:{{date}}、{{time}}、{{title}}

4. 核心插件列表

插件功能
Quick SwitcherCtrl+O 快速切换
Search全局搜索
Graph View图谱视图
Backlinks背链面板
Outgoing Links出链面板
Page Preview悬停预览
Word Count字数统计

社区插件推荐

必装插件

插件功能
Templater高级模板(比内置更强)
Dataview数据查询和索引
Admonition提示块
Advanced Tables表格增强
Local REST API提供 API 接口

辅助插件

插件功能
Switcher++增强快速切换
Find unlinked files查找孤立文件
Tracker数据可视化
Calendar日历视图
Templater高级模板

美化插件

插件功能
Style Settings主题样式定制
Minimal Theme SettingsMinimal 主题设置
Hider隐藏界面元素

Vault 结构建议

简单结构

vault/
├── 00-Inbox/          # 收件箱
├── 01-项目/           # 项目笔记
├── 02-学习/           # 学习笔记
├── 03-工作/           # 工作相关
├── 04-生活/           # 生活记录
├── Daily/             # 每日笔记
└── Templates/         # 模板

MOC (Map of Content) 结构

vault/
├── Maps-of-Content/   # 主题索引
│   ├── 项目管理.md
│   ├── 编程语言.md
│   └── 学习方法.md
├── Notes/             # 原子笔记
├── Daily/             # 每日
└── Templates/         # 模板

工作流程

1. 卡片盒笔记法 (Zettelkasten)

  1. 快速记录想法到 Inbox
  2. 定期整理到永久笔记
  3. 用链接连接相关笔记
  4. 建立 MOC 索引

2. 项目笔记法

  1. 创建项目文件夹
  2. 使用模板创建项目笔记
  3. 链接相关资料
  4. 项目结束后归档

3. 每日笔记法

  1. 早上查看日历和待办
  2. 记录当日重点
  3. 傍晚复盘总结
  4. 链接相关笔记

快捷键

快捷键功能
Ctrl+N新建笔记
Ctrl+P快速切换器
Ctrl+O打开笔记
Ctrl+S保存
Ctrl+B粗体
Ctrl+I斜体
Ctrl+K创建链接
Ctrl+E切换编辑/预览
Ctrl+Shift+E只读预览
Ctrl+,设置
Ctrl+Shift+F全局搜索

同步方案

官方同步

  • Obsidian Sync(付费)
  • 端对端加密
  • 多设备同步

免费方案

方案说明
iCloudmacOS/iOS 原生
OneDriveWindows 推荐
Git版本控制 + 多设备
Syncthing点对点同步

Git 同步配置

## 在 vault 目录初始化
git init
git add .
git commit -m "Initial commit"

.gitignore:

.obsidian/
.trash/
*.md.bak

导出选项

  • Ctrl+P → 导出为 PDF
  • Ctrl+P → 导出为 HTML
  • 插件:Pandoc 导出更多格式
  • 付费:官方 publish 服务

常见问题

1. 笔记丢失

  • 检查 .trash/ 文件夹
  • 使用文件恢复插件
  • Git 历史恢复

2. 同步冲突

  • 使用 Git 时手动合并
  • 建议同一时间只在一台设备编辑
  • 重要笔记定期备份

3. 加载慢

  • 检查插件数量,禁用不需要的
  • 清理未使用的附件
  • 大型仓库可分区管理