导读：Obsidian 装上很容易，难的是装完之后配成顺手的样子。这篇按我自己的配置一步步讲：安装、打开仓库、基础设置、值得开的核心插件，然后是第三方插件：先装三个几乎人人都用的（Templater 模板、Advanced Tables 表格、Excalidraw 画图），再加两个和我工作流相关的，一个让粘贴的图片自动上传到图床，一个把 Claude Code 装进 Obsidian 的侧边栏。
适用版本：Obsidian 1.14.5（macOS）、Templater 2.26.0、Advanced Tables 0.23.2、Excalidraw 2.29.0、Image auto upload 4.1.0、PicGo 2.3.0、Claudian 2.3.34。界面文字以 1.14 为准，老版本的菜单位置可能略有不同。
一、先说清楚：Obsidian 是什么
一句话：Obsidian 是一个打开本地文件夹来写 Markdown 笔记的软件。 你的笔记就是硬盘上一个个普通的 .md 文件，Obsidian 只是帮你把这个文件夹变成一个方便浏览、搜索、互相链接的笔记库。它管这个文件夹叫"仓库"（Vault）。
打个比方：Typora 像一个好用的 Markdown 编辑器，一次专心写一篇；Obsidian 更像一个"笔记文件夹的管理器"，管的是整个文件夹里成百上千篇笔记之间的关系：哪篇引用了哪篇、按标签找、按属性列成表格。
不用它会怎样？笔记多了以后找不到、想不起来以前写过什么，是最常见的问题。笔记只有几十篇、平时都用搜索就能找到，那不装也完全没关系。
什么时候值得用：
- 笔记已经是一堆 Markdown 文件，想要双向链接、全文搜索、按标签和属性整理
- 不想把笔记交给某个云平台，希望数据就在自己硬盘上，换软件也能直接打开
- 想在笔记库里直接用 AI 助手读写文件（后面第八节讲的 Claudian 插件）
我自己的仓库就是平时用 Typora 写笔记的那个文件夹，两个软件打开的是同一批普通 .md 文件，可以同时开着。只注意一点：别在两边同时编辑同一篇笔记，后保存的会覆盖先保存的。
二、安装 Obsidian
macOS
用 Homebrew 装最省事：
bash
# macOS 终端执行：通过 Homebrew 安装 Obsidian
brew install --cask obsidian不用 Homebrew 的话，到官网 obsidian.md/download 下载 dmg，拖进"应用程序"即可。Windows、Linux 也是在这个页面下载对应安装包。
💡 Obsidian 装好后会自己在后台更新。安装包的版本号和实际运行的版本可能不一样：我这台机器的安装包是 1.12.7，实际运行的已经自动更新到 1.14.5。想看实际版本，打开"设置 → 关于"。
第一次打开：把文件夹变成仓库
第一次启动会让你选：
| 选项 | 什么时候选 |
|---|---|
| 新建仓库 | 从零开始写笔记，让 Obsidian 建一个空文件夹 |
| 打开本地仓库 | 已经有一堆 Markdown 笔记，直接选那个文件夹 |
已经有笔记的选"打开本地仓库"就行，Obsidian 不会改动你原有的文件，只会在文件夹里多建一个隐藏的 .obsidian 目录存放自己的配置。
界面默认是英文时，到"Settings → General → Language"改成简体中文，重启生效。
.obsidian 里放了什么
所有设置都在这个目录里，按仓库分开保存，不同仓库可以有不同的插件和主题：
| 文件 / 目录 | 存什么 |
|---|---|
app.json |
编辑器和文件相关的设置，第三节改的几项都存在这里 |
appearance.json |
主题、字体、强调色 |
core-plugins.json |
核心插件的开关 |
community-plugins.json |
启用了哪些第三方插件 |
plugins/ |
第三方插件本体，每个插件一个子目录 |
workspace.json |
当前打开了哪些标签页、侧边栏布局，变化非常频繁 |
三、基础设置：只改这 3 项
设置项很多，刚开始只改下面 3 项就够了，其余保持默认，用一段时间再说。
| 改什么 | 在哪改 | 为什么 |
|---|---|---|
| 重命名时自动更新链接 | 设置 → 文件与链接 | 一定要开，不然一改文件名，引用它的链接全断 |
| 附件存放位置 | 设置 → 文件与链接 | 指定一个固定文件夹（我用的是"附件"），不然粘贴的图片会散落在根目录 |
| 关闭拼写检查 | 设置 → 编辑器 | 中文笔记会满屏红色波浪线 |
💡 写代码多的话，可以顺手在"设置 → 编辑器"里打开显示行号。主题、字体先用默认的，我也只改了一个强调色。
四、核心插件：Obsidian 自带的功能
"核心插件"是 Obsidian 官方自带的功能模块，默认关掉了一部分，在"设置 → 核心插件"里逐个打开。下面是我开着的，按用途分组：
| 用途 | 核心插件 | 干什么用 |
|---|---|---|
| 找笔记 | 文件列表、搜索、快速切换、书签 | 最基础的导航；快速切换按文件名秒开笔记 |
| 笔记之间的关系 | 反向链接、出链、关系图谱、页面预览 | 看谁引用了当前笔记、当前笔记引用了谁；鼠标悬停链接直接预览 |
| 整理结构 | 大纲、标签面板、属性 | 大纲看标题层级；属性就是笔记开头的 YAML 元数据 |
| 日常记录 | 日记、模板 | 每天一篇日记，配合模板自动带上固定结构 |
| 数据视图 | Bases、Canvas（白板） | Bases 把笔记按属性列成表格或看板；Canvas 拖拽卡片画关系 |
| 编辑辅助 | 命令面板、笔记重组、字数统计、文件恢复、编辑状态 | 文件恢复会定时留快照，误删内容能找回 |
几个值得单独说的：
1. 双向链接：Obsidian 最核心的用法
在笔记里输入 [[，会弹出笔记名补全，选中就建立了链接。被链接的那篇笔记，在"反向链接"面板里能看到是谁引用了它。笔记一多，这个功能比文件夹分类好用得多。
markdown
<!-- 在任意笔记里这样写，就链接到了另一篇笔记 -->
缓存问题的排查思路见 [[Redis 缓存穿透排查]]，部署步骤见 [[Spring Boot 打包部署]]。2. 属性 + Bases：把笔记当数据库用
笔记开头的 YAML 块就是"属性"。Bases 能把带属性的笔记列成表格，每一行是一篇笔记，每一列是一个属性，还能排序、筛选，视图有表格、列表、卡片、看板、地图几种。
markdown
---
状态: 已发布
平台: CSDN
日期: 2026-10-26
tags:
- Obsidian
---给一批笔记都加上"状态""日期"这类属性，就能用 Bases 建一个"写作进度表"，不用另外维护 Excel。
3. 文件恢复：误删内容的后悔药
它会定时给笔记留快照，误删了内容可以从文件恢复里按时间找回旧版本，入口在"设置 → 文件恢复"，命令面板里搜"文件恢复"也能打开。不用 Git 管理笔记的话，强烈建议开着。
五、第三方插件怎么装
第三方插件在 Obsidian 里叫"社区插件"，由社区开发者维护。装之前有两件事要知道：
⚠️ 官方帮助文档原话的意思是：社区插件运行的是第三方代码，有可能造成危害。装之前看一眼插件的下载量、GitHub 仓库和最近更新时间。插件市场里有的插件会标注"未经 Obsidian 官方人工审核"，这类更要留意。
安装步骤：
- 打开"设置 → 第三方插件"（英文界面是 Community plugins）
- 第一次使用要先点"开启社区插件"，关闭限制模式
- 点"浏览"，搜索插件名，点"安装"
- 装完点"启用"，或者以后在"已安装插件"列表里打开开关
装好的插件放在 .obsidian/plugins/<插件 id>/ 下，一般就是 main.js、manifest.json、styles.css 三个文件，manifest.json 里能看到版本号和要求的最低 Obsidian 版本。
我现在装了 5 个第三方插件：下一节先讲 Templater、Advanced Tables、Excalidraw 这三个，按插件市场的下载量，它们都排在前几名（Excalidraw 约 870 万次，第一）；再分两节讲图片上传和 Claudian。
六、三个常用插件：Templater、Advanced Tables、Excalidraw
这三个是我按官方插件市场的下载量和最近更新时间挑的：下载量大、一直有人维护，而且解决的都是写技术笔记时天天会碰到的问题。
| 插件 | 版本 | 下载量（2026-10） | 解决什么问题 |
|---|---|---|---|
| Templater | 2.26.0 | 约 600 万 | 新建笔记自动套用固定结构，自动填日期、标题 |
| Advanced Tables | 0.23.2 | 约 330 万 | 编辑 Markdown 表格时自动对齐、Tab 跳格 |
| Excalidraw | 2.29.0 | 约 870 万 | 在笔记里画手绘风格的架构图、流程图 |
安装方法和第五节一样，插件市场里搜名字装上、启用。
Templater：让每篇笔记都有固定结构
它是什么 ：Obsidian 自带一个"模板"核心插件，只能插入固定文字和日期。Templater 是它的加强版，模板里可以写 <% %> 包起来的语法，插入时自动计算，比如今天的日期、当前文件名，还能指定插入后光标停在哪。
第 1 步：指定模板文件夹 。打开"设置 → Templater"，在 Template folder location 填一个文件夹，我填的是仓库根目录下的 templater。这个文件夹里的每篇笔记都会被当成模板。
第 2 步：写模板 。下面是我放在 templater/技术问题排查记录.md 里的模板，排查线上问题时用：
markdown
---
类型: 排查记录
状态: 排查中
日期: <% tp.date.now("YYYY-MM-DD") %>
环境:
tags:
- 排查
---
# <% tp.file.title %>
## 问题现象
<% tp.file.cursor(1) %>
- 出现时间：<% tp.date.now("YYYY-MM-DD HH:mm") %>
- 影响范围：
- 报错信息：
## 排查过程
1.
## 根因
## 解决方案
## 预防措施
- [ ]
## 相关链接
-用到的三个语法：
| 语法 | 插入时变成什么 |
|---|---|
<% tp.date.now("YYYY-MM-DD") %> |
当天日期，格式可以自己改，比如加上 HH:mm |
<% tp.file.title %> |
当前笔记的文件名，拿来当一级标题 |
<% tp.file.cursor(1) %> |
插入完成后光标停在这里，直接开始写 |
第 3 步：插入模板 。新建一篇笔记，先把文件名改成问题本身，比如"Redis 连接超时排查"；然后 Cmd+P 打开命令面板，执行 Templater: Open insert template modal，选模板即可。也可以用 Templater: Create new note from template 一步新建笔记并套用模板。
⚠️ 光标自动跳到
tp.file.cursor的位置，要在 Templater 设置里打开Automatic jump to cursor，它默认是关的。不想开的话，插入后执行Templater: Jump to next cursor location手动跳。💡 模板开头的属性（类型、状态、日期）配合第四节的 Bases，可以建一张"所有还在排查中的问题"的表，一眼看出哪些问题还没结论。
Advanced Tables：写表格不再手动对齐
它是什么：Markdown 表格要靠竖线对齐，内容一改，整列都要重新补空格。Advanced Tables 在你编辑表格时自动处理这些事。
装好就能用，不用设置：
- 光标在表格里按 Tab ，跳到下一个单元格，同时整张表自动对齐；Shift+Tab 回到上一个单元格
- 在最后一行按 Enter，自动新增一行
- 命令面板里有
Format all tables in this file（整理本文件所有表格）、Open table controls toolbar（打开表格工具栏，增删行列、排序）
技术笔记里表格很多，这个插件是我觉得装了以后最省事的一个。
Excalidraw：在笔记里画架构图
它是什么 ：Excalidraw 是一个手绘风格的白板工具，Obsidian 插件把它搬进了仓库：每张图是仓库里的一个文件，可以嵌进任何笔记，改了图，笔记里的图跟着变。
用法：
- 新建画板 ：Cmd+P 执行
Excalidraw: Create new drawing - IN A NEW TAB，在新标签页打开一块空白画布。想直接插进当前笔记，选Create new drawing - IN A NEW TAB - and embed into active document - 画图：顶部工具栏选矩形、箭头、文字等工具拖动绘制，常用单键：R 矩形、A 箭头、T 文字、V 选择
- 连线：箭头从一个方框拖到另一个方框，会吸附在边上，之后移动方框箭头跟着走，画架构图、调用链很顺手
- 嵌进笔记 ：在任意笔记里写
![[画板文件名.excalidraw]]，图就显示在笔记里
新建的画板默认存在仓库根目录的 Excalidraw 文件夹，这是插件设置里 folder 的默认值，可以改。
⚠️ 这三个插件我是 2026-10-27 刚装的，确认都已正常加载（重启 Obsidian 后各自生成了设置文件），模板也已经建好；但 Excalidraw 的画图流程、Advanced Tables 的快捷键是按插件的命令和常规用法写的，我还没有在里面完整画过一张图。
七、插件：Image auto upload，粘贴图片自动上传图床
解决什么问题
Obsidian 默认把粘贴的图片存到本地的附件文件夹，笔记里写的是本地路径。只在自己电脑上看没问题，但笔记要发到博客、公众号，或者换台电脑打开，图片就丢了。
Image auto upload 的做法是：粘贴图片时直接把图片交给 PicGo 上传到图床，笔记里写入的是图床的网络地址。PicGo 是一个桌面端的图片上传工具，支持腾讯云 COS、阿里云 OSS、GitHub、SM.MS 等各种图床。
第 1 步：装好 PicGo 并开启 Server
PicGo 到它的 GitHub Releases 下载安装，macOS 也可以用 Homebrew：
bash
# macOS 终端执行：安装 PicGo 桌面端
brew install --cask picgo⚠️ Homebrew 现在装的是 PicGo 3.x（2026-10 查到的是 3.0.3），我本机用的还是 2.3.0。下面的设置是按 2.3.0 写的，3.x 的菜单位置我没有核对过，找不到时以新版界面为准。
然后在 PicGo 里做两件事：
- 配一个图床：在"图床设置"里填好图床的账号信息，并设为默认图床
- 开启 Server ：在 PicGo 的设置里找到 Server 相关的开关并打开，记下端口，默认是
36677
我的 PicGo 是 2.3.0，Server 开在 127.0.0.1:36677，默认图床是腾讯云 COS。确认 Server 在监听，可以在终端里看一下端口：
bash
# macOS 终端执行：确认 PicGo 的 Server 正在监听 36677 端口
lsof -nP -iTCP:36677 -sTCP:LISTEN能看到一行 PicGo ... TCP 127.0.0.1:36677 (LISTEN)，就说明 Server 开着。
第 2 步：装插件并填 PicGo 地址
在插件市场搜索"Image auto upload"安装并启用。插件设置里，上传器选 PicGo，上传接口填 PicGo 的 Server 地址：
text
http://127.0.0.1:36677/upload这个就是插件的默认值，PicGo 端口没改过的话什么都不用动。之后在笔记里粘贴截图，插件会先传到图床，再把  形式的网络地址写进笔记。
常用的三个操作
| 操作 | 怎么做 |
|---|---|
| 粘贴图片自动上传 | 直接 Cmd+V，默认开启 |
| 把一篇笔记里的本地图片全部上传 | Cmd+P 打开命令面板，输入 upload all images |
| 某篇笔记不想自动上传 | 在这篇笔记的属性里加 image-auto-upload: false |
第三个操作写在笔记开头就行：
markdown
---
image-auto-upload: false
---踩坑提醒
⚠️ PicGo 必须开着。插件只是把图片转交给本机的 PicGo，PicGo 没启动或 Server 没开，粘贴时会上传失败。
另外，插件说明里写了两条：PicGo 2.3.0-beta7 这个版本剪贴板上传不能用，要换其他版本；作者没有在 Mac 上测过，macOS 上传失败可以参考仓库里的 issue #160 和 #20。
八、插件：Claudian，把 Claude Code 装进 Obsidian
解决什么问题
Claudian 把 Claude Code、Codex 这类 AI 编程助手嵌进 Obsidian 的侧边栏。打个比方，它让 AI 助手"住进"你的笔记库：仓库就是 AI 的工作目录，AI 可以直接读写、搜索笔记，执行命令，做多步骤的整理任务，不用在终端和 Obsidian 之间来回切。
适合的场景：
- 让 AI 帮你整理一批笔记的格式、补属性、加双向链接
- 选中一段文字，让 AI 原地改写，改动以逐词对比的方式预览
- 基于已有笔记总结、出一篇新文档
安装前提
| 要求 | 说明 |
|---|---|
| 本机装好至少一个 AI 编程助手 | Claude Code、Codex、OpenCode 等，Claudian 调用的是它们本身 |
| 可用的订阅或 API | 用的是对应助手自己的账号 |
| Obsidian 1.13.0 及以上 | 插件 manifest.json 里写明的最低版本 |
| 只支持桌面端 | macOS、Linux、Windows，手机上用不了 |
⚠️ 插件市场里 Claudian 标注的是"未经 Obsidian 官方人工审核"。它能读写仓库里的文件、执行命令，你的提问和引用的笔记会发给所选的模型服务，笔记里有敏感内容要留意。
安装和打开
- "设置 → 第三方插件 → 浏览"，搜索
Claudian，安装并启用 - 点左侧边栏的 Claudian 图标，或者在命令面板里搜 Claudian 打开对话界面
- 接下来就跟在终端里用 Claude Code 一样，直接对话
💡 插件市场里还有不少名字带 Claudian 的插件，比如 Claudian Plus、Claudian Scheduler，大多是别人做的分支或配套工具。原版的插件 id 是
realclaudian，作者 Yishen Tu。
用的时候记住两个：输入 @ 引用仓库里的文件或文件夹；选中一段文字按快捷键，可以让 AI 原地改写并预览改动。
我的仓库根目录本来就有 CLAUDE.md 和 AGENTS.md，写的是这个笔记库的整理规范。Claude Code 会读工作目录下的 CLAUDE.md，Codex 会读 AGENTS.md，Claudian 调用的就是这些助手，所以笔记规范写在这两个文件里比较合适。不过 Claudian 是否在每个会话里都加载这两个文件，我没有专门验证过，用的时候可以先问 AI 一句"你看到 CLAUDE.md 里的规范了吗"确认一下。这类文件的写法，可以参考我之前写的 Codex + Obsidian 那篇。
九、速查表
默认快捷键（macOS，Windows 把 Cmd 换成 Ctrl，以"设置 → 快捷键"里显示的为准）
| 操作 | 快捷键 |
|---|---|
| 命令面板 | Cmd+P |
| 按文件名快速打开笔记 | Cmd+O |
| 全局搜索 | Cmd+Shift+F |
| 新建笔记 | Cmd+N |
| 切换编辑 / 阅读视图 | Cmd+E |
| 插入双向链接 | 输入 [[ |
| 插入 Templater 模板 | 命令面板执行 Templater: Open insert template modal |
| 表格里跳到下一格并对齐 | Tab（Advanced Tables） |
我的配置一览
| 项 | 设置 |
|---|---|
| 附件文件夹 | 附件 |
| 重命名时自动更新链接 | 开 |
| 核心插件 | 文件列表、搜索、快速切换、反向链接、出链、关系图谱、页面预览、大纲、标签、属性、日记、模板、Bases、Canvas、书签、命令面板、笔记重组、字数统计、文件恢复 |
| 第三方插件 | Templater（模板文件夹 templater）、Advanced Tables、Excalidraw、Image auto upload（配 PicGo + 腾讯云 COS）、Claudian |
.obsidian 目录 |
整个放进 .gitignore，不进 Git |
十、常见问题
Q：.obsidian 目录要不要提交到 Git？
看需求。我是整个目录都放进了 .gitignore，最省事。想在多台电脑之间同步插件和设置，可以提交 app.json、core-plugins.json、community-plugins.json 这类配置，但 workspace.json 一定要忽略：它记录的是窗口布局，几乎每次操作都在变，提交了只会制造冲突。
text
# .gitignore：同步配置但忽略窗口布局
.obsidian/workspace.json
.obsidian/workspace-mobile.jsonQ：粘贴图片没有上传，还是存成了本地文件？
按顺序查三件事：PicGo 有没有启动；PicGo 的 Server 开关有没有打开、端口和插件里填的是不是同一个；PicGo 里默认图床的配置能不能单独上传成功。前两个用上面的 lsof 命令一查就知道。
Q：插件太多会不会拖慢 Obsidian？
第三方插件每个都会在启动时加载，装得越多启动越慢，也越容易互相冲突。我的建议是先把核心插件用熟，真的遇到解决不了的问题再找第三方插件，用不上的就卸掉。
参考链接
- Obsidian 官网下载
- Obsidian 帮助：社区插件
- Obsidian 帮助：Bases
- Templater 插件仓库
- Advanced Tables 插件仓库
- Excalidraw 插件仓库
- Image auto upload 插件仓库
- PicGo 仓库
- Claudian 插件仓库
如果这篇帮你把 Obsidian 配顺手了，点个赞、收个藏，换电脑重装时翻出来照着配一遍就行 👍
你的 Obsidian 装了哪些离不开的插件？欢迎在评论区分享，好用的我试过后补进来。