Hexo 配合 Obsidian Git 插件自动推送

Posted on 2026-04-10

两种方法，一种是手动但完全掌控的，另一种是全自动的，你可以根据自己的偏好来选择。

这个方法最直观、稳定，能帮你清晰地理解背后的工作流程，特别适合刚开始搭建流程的时候。

1. 在 Obsidian 中打开博客目录

打开 Obsidian。
点击左下角的“打开其他仓库”图标（或者用快捷键 Ctrl/Cmd + O）。
选择“打开本地仓库”，然后浏览并选中你的 Hexo 博客根目录（也就是包含 source/_posts/ 的那个文件夹，比如 my-blog）。
Obsidian 会把这个文件夹作为你的新仓库。现在，你就可以在 Obsidian 里看到 source/_posts/ 文件夹，并创建/编辑你的 .md 文章了。

2. 在 Git Bash 中手动同步

这是你需要养成的写作习惯：

如果你希望更进一步，想实现“保存即备份”甚至“定时自动同步”，可以安装社区插件 obsidian-git。

1. 安装与初始化

在 Obsidian 的“第三方插件”里，搜索并安装 Obsidian Git。
首次使用：建议先在博客目录下，通过 Git Bash 手动完成 git init、git remote add origin ...、git push 等初始化操作，确保远程连接正常。之后，obsidian-git 插件就能接管了。

2. 配置自动同步（关键）

你需要在 Obsidian 的设置里找到 Obsidian Git 插件，进行以下配置：

配置项	推荐值	作用
Auto commit interval (minutes)	`5`	每隔5分钟自动提交一次变更
Auto backup after file change	✅ 启用	在你停止编辑文件后，智能启动计时器，准备自动提交
Auto push interval (minutes)	`15`	每隔15分钟自动推送到GitHub
Auto pull interval (minutes)	`60`	每隔60分钟自动从GitHub拉取更新，多设备时很有用

3. 配置 .gitignore 文件

为了避免把无关文件（比如 Obsidian 自身的配置）上传到博客仓库，在博客根目录的 .gitignore 文件中添加一行：

git

.obsidian/

这样，你的 Obsidian 个人设置就不会干扰到 Hexo 的构建了。

综合来看，建议你分两步走：

先使用方法一（手动 Git 工作流）。这能帮你熟悉 Obsidian 与 Hexo 目录的关系，手动 git add/commit/push 也能让你对版本控制更有掌控感。
如果觉得手动操作频繁，再考虑启用方法二（obsidian-git 插件），设置一个较长的自动同步间隔（比如15-30分钟），把它作为一道额外的安全保险。

这样，你既能享受 Obsidian 强大的编辑体验，又能保持 Hexo 构建流程的稳定和干净。

🔍 你需要的是这个插件

插件名称	用途	是否支持自动同步
✅ 你需要的插件	Obsidian Git	支持自动 commit/push/pull

在 Obsidian 的「社区插件」中，搜索 Git，找到名为 Git 的插件（作者：Vinzent03）：

安装并启用插件后，进入插件设置，按以下方式配置：

配置项	推荐值	作用
Auto commit interval (minutes)	`15`	每15分钟自动提交一次变更
Auto push interval (minutes)	`15`	每15分钟自动推送到 GitHub
Auto pull on startup	✅ 启用	启动 Obsidian 时自动拉取远程更新
Commit message	`auto`	使用默认的自动提交信息

初始化仓库（如果还没有）：
- 打开命令面板（Ctrl/Cmd + P）
- 输入 Git: Initialize a new repo
关联远程仓库：

bash

在你的博客目录（my-blog）下打开终端
git remote add origin https://github.com/你的用户名/你的仓库.git
git push -u origin main
日常使用：
- 在 Obsidian 中正常写作
- 插件会按你设置的时间间隔自动 commit 和 push
- 也可以手动点击侧边栏的 Git 图标进行同步

安装正确的插件后，你应该能在 Obsidian 左侧边栏看到一个 Git 分支图标，点击后会显示：

这才是我们要用的插件。快去搜索 Git 安装吧！