什么是Obsidian
Obsidian是一款强大的知识管理工具，基于Markdown文件，采用双向链接和图谱视图来构建个人知识库。与传统笔记软件不同，Obsidian将所有笔记存储为本地纯文本文件，确保数据永远属于你自己。
核心特点
- 本地存储：所有文件保存在本地，完全掌控自己的数据
- Markdown格式：使用通用的Markdown语法，迁移方便
- 双向链接：通过
[[]]创建笔记间的关联 - 图谱视图：可视化展示笔记之间的关系网络
- 高度可定制：丰富的插件生态和主题系统
笔记组织方法
文件夹结构设计
初学者可以从简单的分类开始，随着笔记增多再逐步优化结构：
📁 Vault根目录/
├── 📁 01-日记/
│ └── 每日记录和想法
├── 📁 02-项目/
│ ├── 📁 Blog文章/
│ └── 📁 API文档/
├── 📁 03-知识库/
│ ├── 📁 技术笔记/
│ └── 📁 学习资料/
├── 📁 04-资源/
│ ├── 📁 模板/
│ └── 📁 附件/
└── 📁 99-归档/
标签系统
使用标签（#tag）对笔记进行横向分类：
#todo- 待办事项#idea- 灵感想法#blog/draft- 博客草稿#api/rest- REST API相关#api/graphql- GraphQL相关
命名规范
建议采用统一的文件命名方式：
- 日记：
2024-01-01-周一 - 项目笔记：
项目名-具体内容 - 技术文档：
技术栈-主题-子主题
链接策略
- MOC（Map of Content）：创建内容地图页面，作为某个主题的索引
- 日记链接：在日记中链接到当天创建或修改的笔记
- 相关笔记：在笔记底部添加"相关链接"部分
必备插件推荐
基础增强类
1. Calendar
- 功能：日历视图，快速创建和查看日记
- 使用：点击日期创建当天日记，右键查看周记/月记
- 快捷键：
Ctrl+Shift+C打开日历
2. Templater
- 功能：强大的模板系统，支持变量和脚本
- 使用：创建模板文件，插入时自动替换变量
- 示例模板：
---
title: <% tp.file.title %>
date: <% tp.date.now("YYYY-MM-DD") %>
tags: []
---
## 概述
## 内容
## 总结
3. Dataview
- 功能：将笔记库当作数据库查询
- 使用：通过查询语句动态显示笔记列表
- 示例：
table date, tags
from "02-项目/Blog文章"
where contains(tags, "已发布")
sort date desc
编辑优化类
4. Quick Add
- 功能：快速添加笔记、执行命令
- 使用：配置快捷操作，一键创建特定类型笔记
5. Natural Language Dates
- 功能：自然语言解析日期
- 使用：输入"tomorrow"、“next week"自动转换为具体日期
6. Auto Link Title
- 功能：粘贴URL自动获取网页标题
- 使用：直接粘贴链接，自动转换为
[标题](URL)格式
视觉增强类
7. Kanban
- 功能：看板视图管理任务
- 使用：创建
.kanban文件，拖拽卡片管理进度
8. Mind Map
- 功能：思维导图视图
- 使用：将大纲结构可视化为思维导图
Blog文章管理实践
文章生命周期
灵感收集
- 在日记中记录想法
- 标记
#blog/idea
草稿撰写
--- title: 文章标题 status: draft tags: [blog/draft] created: 2024-01-01 ---内容完善
- 使用子标题组织结构
- 添加代码块和示例
- 插入图片和图表
发布管理
- 更新status为published
- 记录发布平台和链接
- 创建相关笔记链接
Blog模板示例
---
title: {{title}}
date: {{date}}
status: draft
tags: [blog/draft]
category:
platform: []
url:
---
## 前言
## 主要内容
### 要点1
### 要点2
### 要点3
## 代码示例
\`\`\`language
// 代码
\`\`\`
## 总结
## 参考资料
-
## 相关笔记
- [[]]
API文档整理方法
文档结构
📁 API文档/
├── 📁 项目名/
│ ├── 📄 API概览.md
│ ├── 📁 接口文档/
│ │ ├── 用户模块.md
│ │ └── 订单模块.md
│ ├── 📁 数据模型/
│ └── 📁 示例代码/
API文档模板
# API名称
## 基本信息
- **路径**: `/api/v1/resource`
- **方法**: `GET/POST/PUT/DELETE`
- **认证**: Bearer Token
## 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | string | 是 | 资源ID |
| name | string | 否 | 资源名称 |
## 请求示例
\`\`\`json
{
"id": "123",
"name": "example"
}
\`\`\`
## 响应格式
### 成功响应
\`\`\`json
{
"code": 200,
"data": {},
"message": "success"
}
\`\`\`
### 错误响应
\`\`\`json
{
"code": 400,
"error": "Invalid parameters",
"message": "参数错误"
}
\`\`\`
## 使用示例
\`\`\`javascript
fetch('/api/v1/resource', {
method: 'POST',
headers: {
'Authorization': 'Bearer token',
'Content-Type': 'application/json'
},
body: JSON.stringify(data)
})
\`\`\`
## 注意事项
-
API测试记录
使用Dataview插件创建API测试仪表板：
table
method as "方法",
status as "状态",
last-tested as "最后测试"
from "API文档"
where contains(tags, "api")
sort last-tested desc
快捷键配置
常用快捷键设置建议：
| 功能 | 快捷键 | 说明 |
|---|---|---|
| 快速切换 | Ctrl+O | 快速打开文件 |
| 命令面板 | Ctrl+P | 执行命令 |
| 创建链接 | Ctrl+K | 选中文字创建链接 |
| 切换编辑/预览 | Ctrl+E | 切换视图模式 |
| 搜索替换 | Ctrl+H | 当前文件搜索替换 |
| 全局搜索 | Ctrl+Shift+F | 搜索所有笔记 |
| 插入模板 | Alt+T | Templater插入模板 |
| 每日笔记 | Alt+D | 创建/打开今日笔记 |
进阶技巧
1. CSS代码片段
创建自定义样式文件放在.obsidian/snippets/目录：
/* 自定义标签颜色 */
.tag[href="#todo"] {
background-color: #ff6b6b;
color: white;
}
.tag[href="#done"] {
background-color: #51cf66;
color: white;
}
2. 搜索技巧
path:文件夹名- 在特定文件夹搜索tag:#标签名- 搜索特定标签file:文件名- 搜索文件名/正则表达式/- 正则搜索
3. 嵌入内容
![[笔记名]]- 嵌入整个笔记![[笔记名#标题]]- 嵌入特定章节![[笔记名^块ID]]- 嵌入特定块
总结
Obsidian的强大之处在于其灵活性和可扩展性。作为初学者，建议从基础功能开始，逐步探索适合自己的工作流程。记住，最好的系统是你能坚持使用的系统。
随着使用深入，你会发现Obsidian不仅是笔记工具，更是思维的延伸和知识的第二大脑。