---
title: "Obsidian"
type: entity
tags: [笔记工具, 知识管理, 双链笔记]
sources:
  - obsidian-cli
last_updated: 2026-04-16
---

# Obsidian

## Aliases
- Obsidian.md
- Obsidian 笔记

## 描述
本地优先的笔记和知识管理工具，支持双链笔记、Graph View 图谱视图和丰富的社区插件生态。通过 iCloud Drive 或 Obsidian Git 插件实现多端同步。

## 核心特性

### 双链笔记 (Bidirectional Links)
通过 `[[wikilinks]]` 语法在页面间建立双向链接，形成知识网络而非孤岛。

### Graph View
左侧边栏图谱图标（或 `Ctrl+G`）将所有 Wiki 页面以节点展示，双链关系自动连线：
- **健康检查**：没有任何页面链接指向它 → 孤岛页面，需要补上交叉引用
- **发现盲区**：某个概念被很多页面提到但自己还没有独立页面 → 灰色幽灵节点

### 社区插件
- **Obsidian Git**：自动 commit + push 到 Git 仓库
- **Obsidian Web Clipper**：浏览器插件，快速采集网页文章为 Markdown
- **Dataview**：类似数据库的笔记查询
- **Tasks**：任务管理
- **Templater**：动态模板

## 与 AI Agent 的集成

### 目录结构（OpenClaw 用法）
```
/Users/weishen/Workspace/nexus/
├── openclaw/
│   ├── knowledgebase/       ← 经过整理、跨 Agent 共用的知识
│   ├── xingshu/            ← 星枢专属笔记
│   ├── xinghui/            ← 星辉专属笔记
│   ├── xingyao/            ← 星曜专属笔记
└── …（其他 Obsidian 笔记）
```

### OpenClaw obsidian skill
支持的操作：
- `obsidian write` — 创建或覆盖一篇笔记
- `obsidian append` — 在已有笔记末尾追加内容
- `obsidian read` — 读取笔记内容
- `obsidian search` — 在笔记库中搜索关键词
- `obsidian update` — 修改笔记的特定部分

## 图片本地化
剪藏的网页文章图片通常是外链，几个月后失效。解决方案：
1. 设置 → 文件与链接 → 附件存储路径 → 设为当前文件夹下的 `attachments/` 子目录
2. 绑定下载快捷键（如 `Ctrl+Shift+D`）→ 剪藏完按一下快捷键，所有图片自动下载到本地

## 相关来源
- [[养虾日记3-用-obsidian-gitea-为-ai-助手构建持久化笔记系统]]
- [[obsidian-高效指南-我常用的插件与实用技巧]]
- [[obsidian最有必要安装的10款插件是这些]]
- [[Obsidian Tasks 插件-这可能是最适合懒人的任务管理方式]]
- [[dataview-让我从笔记黑洞里逃出来的-obsidian-神器-1]]