Obsidian “邪修”全能实战指南

——转写自B站技术爬爬虾

核心理念：

1. 数据在你手中：本地 Markdown 文件，安全第一。
2. GitHub 免费同步：白嫖全球最强代码托管平台，稳如泰山。
3. AI 本地化：用 AI (Gemini) 直接操作本地文件，实现自动化整理。

第一阶段：搭建免费且最稳的云同步 (PC端)

我们要利用 GitHub 来替代收费的云同步服务。

1. 准备工作

• 注册 GitHub 账号。
• 下载并安装 GitHub Desktop (可视化操作工具，不用敲代码)。
• 安装 Obsidian 客户端。

2. 创建云端仓库

1. 登录 GitHub 网页版，点击右上角 + 号 -> New repository。
2. Repository name：起个名字（例如 My-Obsidian-Notes）。
3. Visibility：务必选择 Private (私有)，防止笔记泄露。
4. 点击 Create repository。

3. 克隆到本地

1. 打开 GitHub Desktop 软件，登录你的 GitHub 账号。
2. 点击 File -> Clone repository。
3. 找到刚才创建的仓库，选择本地硬盘的一个路径，点击 Clone。
4. 此时，你电脑上会出现一个空文件夹，这就是你的“本地笔记库”。

4. Obsidian 初始化与防冲突配置

1. 打开 Obsidian -> 打开本地仓库 -> 选择刚才克隆的文件夹。
2. 关键步骤：配置 .gitignore (防止同步冲突)
   • 在电脑文件夹里（即你的仓库根目录），右键新建一个文本文档，命名为 .gitignore (注意前面有个点，如果提示必须有文件名，可以先叫 a.txt 然后用编辑器打开另存为 .gitignore)。
   • 用记事本打开它，复制以下两行内容进去并保存：

     .obsidian/workspace.json
     .obsidian/workspace-mobile.json
     

   • 回到 GitHub Desktop，左下角 Summary 填 "init"，点击 Commit to main，然后点击 Publish branch。

5. 安装 Git 插件实现全自动

1. Obsidian 设置 -> 第三方插件 -> 关闭安全模式 -> 浏览。
2. 搜索 Obsidian Git -> 安装 -> 启用。
3. 配置插件 (设置 -> Git)：
   • Auto commit and sync after stopping file edits: 开启。
   • Timeout: 建议改为 1 (分钟)。即停笔 1 分钟后自动上传。
   • Pull updates on startup: 开启。每次打开软件自动拉取最新笔记。

第二阶段：优雅的图片管理 (根据您的截图更新)

默认粘贴图片很乱，这一步能让你的图片自动分类存好，并且生成的链接符合标准 Markdown 语法，方便在其他软件查看。

1. 安装插件

• Obsidian 设置 -> 第三方插件 -> 浏览 -> 搜索并安装：Custom Attachment Location -> 启用。

2. 精准配置 (请直接复制下方代码)

打开该插件的设置页面，完全按照您提供的截图填写以下内容：

• 新附件位置 (Location for new attachments):
  粘贴下方代码（作用：在当前笔记下自动建立 assets 文件夹并归类）：

  ./assets/${noteFileName}
  

• 生成的附件文件名 (Generated attachment filename):
  粘贴下方代码（作用：用精确到毫秒的时间戳重命名图片，防止文件名重复）：

  file-${date:YYYYMMDDHHmmssSSS}
  

• Markdown URL 格式 (Markdown URL format):
  这是最关键的一步，粘贴下方代码（作用：生成标准的相对路径链接）：

  assets/${noteFileName}/${generatedAttachmentFileName}
  

• 其他设置:

  • 附件重命名模式 (Attachment rename mode): 下拉选择 仅粘贴的图片 (Only pasted images) (或者视频中提到的“全部”)。
  • 是否重命名附件文件: 记得打开右侧的 紫色开关。

3. Obsidian 系统设置调整

为了配合插件，还需要改一个系统设置：

• Obsidian 设置 -> 文件与链接。
• 使用维基链接 (Use Wiki links): 取消勾选 (关掉)。
• 内部链接类型: 建议选“基于当前笔记的相对路径”。

效果：你在笔记里直接粘贴截图，图片会自动进入 assets/笔记名/ 文件夹，文件名会自动变成时间戳，链接会自动变成标准格式。

第三阶段：接入 AI Agent (Gemini CLI)

让 AI 帮你写笔记、整理文件。

1. 环境准备：
   • 安装 Node.js。
   • 在笔记文件夹 -> 右键 -> 在终端打开 -> 输入 npm install -g @google/generative-ai。
2. 启动：
   • 输入 gemini chat -> 选择 Login with Google 授权。
3. 玩法：
   • 在终端里用自然语言命令 AI，例如：“读取‘未来选题’文件夹里的所有文件，根据内容生成一个汇总表格文件。”

第四阶段：手机端同步 (Android)

1. 首次物理传输：用数据线把电脑配置好的笔记文件夹，完整复制到手机 (建议放在 Documents 目录下)。
2. 打开笔记：手机 Obsidian -> Open folder as vault -> 选择该文件夹。
3. 配置 Git：
   • 手机端启用 Obsidian Git 插件。
   • 填入 GitHub 用户名。
   • 密码栏 (Token)：注意！这里不能填登录密码。
     • 去 GitHub 网页 -> Settings -> Developer settings -> Personal access tokens (Classic) -> Generate new token。
     • 权限勾选 repo，有效期选 No expiration。
     • 复制这串乱码 Token，填进手机插件的密码栏。
4. 日常使用：写完笔记下拉一下，或者等它自动同步。

常用 Markdown 语法速查表