Obsidian 完整配置指南

用了一圈笔记软件，最后还是回到了 Obsidian。主要是看中它离线优先、纯文本存储，而且插件生态足够丰富。通过一些配置，可以把它变成一个免费、高效、还能接入 AI 的知识库。

为什么选 Obsidian？

• 离线优先：没网也能用，加载速度快，不用担心服务商跑路。

• 纯文本：所有笔记都是 Markdown 格式，迁移成本低，用什么编辑器都能打开。

• 插件丰富：社区插件质量高，自动同步、AI 工作流这些功能都能通过插件实现。

一、下载与安装

直接去 Obsidian 官网 下载，安装过程无脑下一步就行。

二、用 GitHub 实现自动同步

GitHub 不仅免费，关键是能版本回溯。万一哪天手滑删错了，还能找回来。

1. 创建仓库

在 GitHub 上新建一个 Repository：

• Name：随便起，比如 MyNote。
• Visibility：建议选 Private，毕竟是私人笔记。

2. 本地克隆

下载 GitHub Desktop，然后：

• 点击 File -> Clone Repository。
• 选择刚才创建的仓库，设置一个本地路径（这个路径就是你的 Obsidian 库）。

三、避坑配置：.gitignore

在库根目录下新建 .gitignore 文件，填入以下内容：

# 忽略工作区布局文件，避免多设备打开不同文件导致的冲突
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/graph.json
.obsidian/cache/

这样可以避免多设备之间因为打开不同文件而产生冲突。

四、配置 Obsidian Git 插件

在 Obsidian 设置里找到插件，确认”我同意关闭安全模式”，然后搜索 Obsidian Git 插件并安装。

安装后进入 Settings -> Obsidian Git：

• Vault backup interval：设置为 1（每分钟自动备份）。
• Auto pull interval：设置为 1（每分钟检查云端更新）。
• Pull updates on startup：记得开启，这样打开软件就能看到最新内容。
• On backup history：建议开启，每次提交都会带上时间戳。

五、解决附件管理混乱问题

默认情况下，Obsidian 粘贴图片会直接堆在根目录，时间长了一团乱。通过插件可以让附件跟着笔记走。

1. 安装 Custom Attachment Location 插件

在插件市场搜索 Custom Attachment Location，点击安装。

安装后在插件设置中配置：

• Location for new attachments：选择 ./assets/${filename}。
  • 效果：如果你在写 播客.md，图片会自动存入 assets/播客/ 文件夹。
• Attachment link format：选择 Relative path from current file（相对路径）。
• Auto rename attachment：开启。修改笔记文件名时，对应的图片文件夹也会自动改名。

2. 系统设置配合

进入 设置 -> 文件与链接：

• 使用 Wiki 链接：关闭（这是关键！关闭后链接会变成标准 Markdown 格式 ![]()，这样在 GitHub 和 VS Code 里图片才能正常显示）。
• 新附件存储位置：选择”由插件定义”。

六、接入 AI 工具

这里以 Gemini-CLI 为例，当然你也可以用我在低成本玩转AI Agent搞Vibe Coding这篇文章里提到的其他工具。

1. 环境准备

1. 安装 Node.js。

2. 打开终端（CMD 或 PowerShell），定位到你的笔记文件夹：

   cd "你的笔记路径"
   npm install -g @google/generative-ai  # 安装基础库
   npx gemini-chat-cli login             # 登录授权

2. 常用指令示例

你可以直接在终端输入指令，让 AI 帮你处理笔记：

• 归纳总结："分析播客下的所有 md 文件，给我列出我后续可以写的主题。"
• 风格分析："根据我播客下的md文件，分析我的语言风格"
• 文件整理："把博客文章里所有没有描述的文件找出来，填上合适的文章描述，50至100字"

温馨提示：如果担心 AI 弄乱文件夹，Git 的作用就体现了。右键 Discard Changes 就能一键还原 AI 的所有修改。

七、移动端同步方案

移动端同步是很多人的痛点。这里分享一个”手动拷贝+Git 插件”的方案。

1. 初始同步

通过数据线，将电脑上的 Obsidian 整个文件夹拷贝到手机的 Documents/Obsidian 目录下。

2. 配置 Personal Access Token

1. 电脑打开 GitHub：Settings -> Developer settings -> Personal access tokens -> Tokens (classic)。

2. 生成新 Token，勾选 repo 全部权限。保存好这个字符串！

3. 手机 Obsidian 进入 Git 插件设置：

   • Authentication method：选择 Personal Access Token。
   • Username：你的 GitHub 用户名。
   • Password/Token：粘贴刚才生成的字符串。

八、进阶功能

1. 导出 Word/PDF

安装 Pandoc，然后在笔记上右键选择 Export。它会自动处理图片路径问题，导出的 Word 文档里图片是完美嵌入的。

2. 双向链接使用技巧

• 不要为了链接而链接，有意义的连接才有价值。
• 使用 [[笔记名|自定义文字]] 可以让链接更自然。
• 在图谱设置里，利用 Groups 功能给不同文件夹设置不同颜色，这样图谱会更清晰。

总结

我现在的工作流是这样的：

1. 输入：手机端随时记录，Git 自动推送到 GitHub。
2. 整理：电脑端打开，插件自动归类图片。
3. 处理：每周用 AI 扫描一遍笔记库，生成总结和新的想法。
4. 备份：每一分钟，数据都在 GitHub 有备份。

折腾一次，后面就能一直爽了。希望对你有帮助。