1.准备Github和Git
Github上新建repository,访问权限根据个人需要设置public和private,可以选择添加readme.md(后续需要额外操作),建议建立空仓库。
将Git的bin目录和cmd目录路径放在用户或系统的path中(高级系统设置)
2.用户和网络配置
可以等到Git Bash给出提示时再相应地处理。
2.1用户配置
在目标位置右键Open Git Bash,执行代码
git config --global user.email "your-email@example.com"
git config --global user.name "Your Name"
这样Git知道我们是仓库的master了。
2.2网络配置
网络上希望使用国内的,可以使用Gitee,就无需网络配置了。
首先需要始终打开魔法Clash Verge, 点开设置-系统代理旁的齿轮(设置键),其中告知了服务地址,如127.0.0.1:xxxx,将地址填入下面代码运行
git config --global http.proxy http://127.0.0.1:xxxx
git config --global https.proxy http://127.0.0.1:xxxx
这样就让本地obsidian与Github仓库连接了。
3.obsidian仓库设置
如果还未建立obsidian仓库,则在本地选择一个位置打开Git Bash执行下面代码(比如你目标obsidian仓库为myvault,则在myvault目录下执行代码)
git clone Github仓库URL
之后点开obsidian选择该文件夹打开即可。
如果是已有的obsidian仓库,比如myvault,在目录下打开Git Bash,执行下面代码
git init // 初始化仓库
git branch -m main // 重命名当前分支为main
git remote add origin Github仓库URL // 添加远程仓库
由于obsidian仓库里有一些文件的变动是琐碎的,比如workplace.json记录的是面板的浏览记录,打开哪些面板之类的信息,无需更新在Github上,这里提供.gitignore文件来忽视这些文件。(创建.txt,填入代码然后修改文件名及文件后缀名)
# 忽略操作系统自动生成的文件
.DS Store
Thumbs.db
# 忽略Obsidian的缓存文件
.obsidian/cache
# 忽略特定设备的工作区状态,这是避免冲突的关键
# 这是你本次操作的核心目标
.obsidian/workspace.json
.obsidian/workspaces.json
.obsidian/workspace-mobile.json
# 忽略其他不建议同步的文件
.obsidian/daily-notes.json
.obsidian/facets/json
.obsidian/starred.json
# 忽略插件的缓存和数据文件(可选,但推荐)
# .obsidian/plugins/some-plugin/data.json
.obsidian/plugins/recent-files-obsidian/data.json
# 忽略垃圾箱文件夹
.trash/
4.首次提交与推送
Git Bash输入
git add . // 将工作区的更改添加到暂存区
git commit -m "first commit" // 引号内是自定义内容,为此次push命名
git push -u origin main // 将本地的main分支推送到远程origin,并建立跟踪关系以便后续简化操作
这里的最后一条指令可能会出现上面第2点的提示,按照提示执行第2点的代码即可。
5.安装并配置Obsidian Git
在Obsidian的第三方插件中安装Git,这里可能弹出无法找到Git命令之类的,按照第1点将路径设置好即可。
进入Obsidian Git设置页面,配置
- Pull on startup开启
- Auto commit interval(minutes)自动提交时间,建议1min
- Push on commit-and-sync开启,在提交并同步时推送
除此之外,如果在完成编辑后需要马上关闭,先点击Git插件的UI界面左上角的Commit and Sync,实现同步和推送。


