简明Obsidian Git同步教程
PC端配置
安装Git
- PC端配置Git首先需要下载Git(官网 https://git-scm.com/downloads )。以Windows为例,图中任意版本的Git均可,但是我比较推荐下载压缩包版本(Portable)。因为这样我们可以保证Git的所有依赖文件都在压缩包内,很方便管理以及迁移。

- 如果你没有使用过Git,你需要先完成初始化。点开Git-bash输入下面的命令配置相关信息:
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"
配置插件
在Obsidian插件市场搜索Git,下载Git插件,在Custom Git Binary Path这里填上git.exe的路径。git.exe位于解压后文件夹的bin目录下。

配置仓库
Obsidian在一个文件夹中存放所有笔记,这个文件夹称之为仓库(vault);Git管理的对象也是文件夹,这个文件夹也称作仓库(repository)。要实现同步,我们需要配置本地的仓库和云端的仓库,然后让Git在仓库之间同步。
本地仓库
在Obsidian中打开命令行,搜索初始化仓库的命令:

这样本地仓库就配置好了。此时你如果希望只同步笔记内容,不同步设置、插件以及主题等内容的话你就需要要求Git不同步仓库根目录上的.obsidian文件夹。搜索命令Git: Edit .gitignore,在里面加上一行.obsidian即可。

远程仓库
远程仓库是同步笔记的中转站,也是云端备份。最著名的Git远程仓库平台是Github,但是由于网络问题,我建议用Gitee来作为我们的远程仓库托管平台。在Gitee上可以免费创建仓库,但是有一定容量限制,因此我建议不要笔记库中存放PDF、视频之类的文件。
点击右上角+号创建仓库:

注意不要选择开源仓库,这样会导致笔记内容被他人看见。
使用ssh进行push/pull
- 生成 SSH 密钥,在终端执行:
ssh-keygen -t ed25519 -C "你的邮箱" -f ~/.ssh/自定义名字(xxx.ed25519)
一路按回车即可。
2. 复制公钥,Windows PowerShell 执行:
Get-Content ~/.ssh/id_ed25519.pub
复制输出的整行内容。
3. 添加到 Gitee
4. 修改本地远程地址,在 Obsidian 库目录执行:
git remote set-url origin git@gitee.com:你的用户名/你的仓库名.git
- 测试并推送
ssh -T git@gitee.com
Android端配置
手机端Obsidian Git插件本身内置了git,但是极度不稳定。我建议使用Git Sync这个app来代替Obsidian Git插件。


浙公网安备 33010602011771号