笔记软件Obsidian + Git 免费同步

内容来自b站技术爬爬虾【Obsidian邪修用法，免费云同步，AI，手机端，进阶技巧】 https://www.bilibili.com/video/BV1fZCyBYEuT/?share_source=copy_web&vd_source=4f04bc8bd62466f5a82d76e73cd0dc77
。本人没经过授权私自搬运，原作者看见可以叫我取消发布。内容先是自己操作一遍后写个一步步的文字版教程。然后叫ai排版。因为df没有技术分享，所以发在闲聊区
这份 Obsidian 结合 GitHub 的同步教程非常实用！为你进行排版和结构优化，完全保留了你的所有操作细节，并按照论坛帖子的阅读习惯增加了清晰的层级、加粗重点和代码块。

你可以直接复制以下内容发布：（这个不删证明是ai润色）

Obsidian + GitHub 免费多端同步与附件管理教程

如果你想使用 Git 来免费同步 Obsidian 笔记并管理图片附件，可以参考以下完整的配置流程。

一、 GitHub 仓库与本地环境准备

1. 创建 GitHub 仓库

   • 前往 GitHub 新建仓库。
   • 创建一个新的仓库，Choose visibility 选项请务必选择 Private（私有仓库，保护笔记隐私）。

2. 下载 GitHub Desktop

   • 前往 GitHub Desktop 官网 下载客户端并安装登录。

3. 克隆仓库到本地

   • 打开 GitHub Desktop，在左上角点击 File -> Clone a repository。
   • 选择克隆到一个空的文件夹中。

二、 Obsidian 仓库初始化与 Git 忽略配置

4. 在 Obsidian 中打开仓库

   • 打开 Obsidian，选择打开本地仓库。
   • 选择你刚刚克隆下来的文件夹（里面会有你在 Git 上的项目名字的文件夹）。

5. 配置 .gitignore 忽略文件

   • 在克隆了 Obsidian 仓库文件夹后，在本地打开 Git 项目文件夹。
   • 你会看到里边有 .obsidian 文件夹，其中包含 workspace.json 等本地工作区状态文件。这些文件不能上传到 Git 上，否则会引起多端冲突。
   • 在克隆的根文件夹里，创建一个名为 .gitignore 的文件，填上以下内容：

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

三、 首次提交与同步

6. 完成首次 Commit 与 Push
   • 回到 GitHub Desktop，你应该能在左侧 Changes 里看到刚才新增的 .gitignore，以及 vault 里的其他文件。
   • 检查一下：.obsidian/workspace.json 和 .obsidian/workspace-mobile.json 不应该出现在待提交列表里，因为它们已经被 .gitignore 忽略了。
   • 在左下角 Summary 写一句提交说明，比如 init obsidian vault，然后点 Commit to main。
   • 提交完成后，再点上方的 Push origin，把这次提交推到你刚建好的远程仓库。
   • (注：这个操作就是手动上传同步了一次)

四、 Obsidian 插件配置 (自动化与附件管理)

7. 配置 Git 自动同步插件

   • 回到 Obsidian 添加第三方插件，搜索 Git，安装并启用，进入选项：
   • 打开 Pull on startup。
     • 作用：你每次打开这个 vault 时，插件会先尝试把远端仓库的新内容拉下来。
   • 把 Auto commit-and-sync interval (minutes) 改成 5。
   • 然后把下面那个 Auto commit-and-sync after stopping file edits 打开。
     • 作用：会在你停止编辑后 5 分钟去自动同步。

8. 图片与附件管理配置

   • 搜索插件 Custom Attachment Location，安装启用并进入选项：
   • 附件重命名模式：选择“全部”。
   • 是否重命名附件文件夹：开启。
   • 在 Advanced 的 Markdown URL 格式 中填入：
     assets/{noteFileName}/{generatedAttachmentFileName}

9. Obsidian 核心链接设置

   • 回到 Obsidian 的基础设置：
   • 将 使用 Wiki 链接 关闭。
   • 内部链接类型 选择 基于当前笔记的相对路径。