为什么选择 Obsidian？
Obsidian 是一款基于本地 Markdown 文件的笔记与知识管理工具。
和 Notion、语雀等云端笔记不同，Obsidian 的数据以标准 .md 文件存储在本地：
- 数据完全掌控：文件在你自己的硬盘上，不依赖任何云服务
- 双向链接：在笔记之间建立引用关系，构建个人知识网络
- 插件生态丰富：社区提供上千款插件，覆盖 Git 同步、AI 集成、导出等场景
- 个人免费使用：无需付费、无需注册账号
本指南覆盖从基础配置到进阶使用的完整流程。
一、基础设置
安装 Obsidian 后，先做好以下配置。
1. 附件存放路径
默认情况下粘贴图片会保存到根目录，笔记多了之后非常杂乱。建议修改为按子目录归档：
设置 → 文件和链接 → 附件默认存放路径 → 当前文件夹下的指定子文件夹
这样每个笔记的图片都会归类到各自子目录，保持仓库整洁有序。
2. 与 GitHub 联动的准备
准备将笔记同步到 GitHub 前，需要在 Obsidian 中做一些兼容性调整——关闭 Wiki 链接模式，改用标准 Markdown 路径：
设置 → 文件与链接 → 关闭 Wiki 链接 → 内部链接类型选择「基于当前笔记的相对路径」
这一步很关键：Wiki 链接（[[笔记名]]）在 GitHub 和其他 Markdown 阅读器中无法正确解析，改为标准格式后，笔记在任何平台都能正常浏览。
3. 安装导出插件
如果需要将笔记导出为 Word、PDF、HTML 等格式，安装 Enhancing Export 插件：
- 在社区插件市场中搜索并安装 Enhancing Export
- 下载 Pandoc（通用文档转换工具）
- 解压 Pandoc，将其可执行文件路径填入 Enhancing Export 设置中
配置完成后即可在 Obsidian 内一键导出为多种文档格式。
二、Markdown 格式速查
Obsidian 的核心编辑体验基于 Markdown，以下是最常用的操作备忘。
文本样式
| 格式 | 快捷键 | 语法 |
|---|---|---|
| 加粗 | Ctrl + B |
**文本** |
| 斜体 | Ctrl + I |
*文本* |
| 行内代码 | — | `代码` |
链接
- 内部链接：
[[笔记名]]链接到仓库内其他笔记 - 外部链接：
[显示文字](https://地址)，或选中文字后Ctrl + K快速插入
图片
直接粘贴图片即可，Obsidian 会自动保存到附件目录。
为了让图片路径更加规范、便于其他 Markdown 阅读器打开，推荐安装 Custom Attachment Location 插件，并进行如下设置：
- Markdown URL 格式：
assets/${noteFileName}/${generatedAttachmentFileName} - 附件重命名模式：选为「全部」
开启「文件重命名同步」后，在 assets 目录下修改图片文件名，笔记内的引用也会自动更新。
配置完成后，Obsidian 生成的图片路径为标准格式 ，图片保存在当前目录下的 assets 子文件夹中。
注意：以上配置需要同时关闭 Wiki 链接（参见第一节第 2 步），否则图片路径仍会使用 Wiki 格式。
列表
- 无序列表：
-+ 空格 - 有序列表：
1.+ 空格
表格
Ctrl + P 打开命令面板，搜索「表格」→「插入表格」，选择行列数即可快速生成：
| 列 A | 列 B | 列 C |
|------|------|------|
| 内容 | 内容 | 内容 |
引用
Ctrl + P 打开命令面板，搜索「标注」即可插入块引用：
这是引用的内容。适合用于高亮重点、摘录名言或展示补充说明。
三、进阶功能
1. 文件属性
点击笔记右上角省略号 → 增加笔记属性，可以为笔记添加结构化元数据，属性支持文本、数字、日期、列表等多种类型。
通过统一管理属性字段，结合 Dataview 插件可以实现对笔记的聚合查询与分析，挖掘笔记之间的隐藏关联，实现类似数据库的检索能力。
2. Git 云端同步
将 Obsidian 仓库同步到 GitHub 是最可靠的免费备份与多端同步方案。
第一步：创建远程仓库
在 GitHub 创建私有仓库（笔记涉及隐私，建议设为私有）。
第二步：本地初始化
在 Obsidian 仓库目录下初始化 Git：
cd your-obsidian-vault
git init
git add .
git commit -m "初始化笔记仓库"
git remote add origin https://github.com/你的用户名/仓库名.git
git push -u origin main
第三步：安装 Git 插件
- 设置 → 第三方插件 → 关闭安全模式
- 在社区插件市场搜索并安装 Git
- 配置自动同步间隔
启用后 Obsidian 会按设定间隔自动 commit 并 push 变更，实现笔记的自动备份。如果有多台设备，建议也配置 pull 间隔以保持双向同步。
┌──────────────┐ git push ┌──────────┐ git pull ┌──────────────┐
│ 电脑 A │ ──────────▶ │ GitHub │ ◀────────── │ 电脑 B │
│ (Obsidian) │ │ (私有仓) │ │ (Obsidian) │
└──────────────┘ └──────────┘ └──────────────┘
这套方案比 Obsidian 官方付费同步服务更灵活，且完全免费。
3. AI 功能集成
Obsidian 社区提供了多款 AI 相关插件，可以在笔记中直接调用大模型能力：
- Text Generator：选中文本后一键生成、续写或改写
- Copilot：侧边栏对话式问答，上下文感知当前笔记
- Smart Connections：利用嵌入模型计算笔记间语义相似度，发现隐藏关联
安装方式与其他插件相同——在社区插件市场搜索名称即可。
总结
Obsidian 的上手并不复杂，掌握以下三个阶段即可拥有一个完全自主、高度可扩展的知识管理环境：
| 阶段 | 要点 |
|---|---|
| 基础设置 | 配置附件路径、关闭 Wiki 模式、安装导出插件 |
| Markdown 格式 | 掌握文本样式、链接图片、列表表格、引用等语法 |
| 进阶功能 | 文件属性 + Git 云端同步 + AI 插件 |
后续可以进一步探索 Dataview 数据查询、Templater 模板引擎、Excalidraw 手绘图表等， 让 Obsidian 成为真正属于你自己的「第二大脑」。
好的工具是思维的延伸。Obsidian 给你的不是条条框框，而是可以自由书写的无限画布。