Obsidian笔记同步Github仓库工作流

记录本知识库备份至 Github 仓库的工作流。

准备工作

Git 安装

1、前往Git 官网下载并安装

按照安装程序默认勾选的配置安装即可。
2、验证 Git 是否安装成功
按 Win + R 打开 Cmd 命令行窗口输入：git help 有输出即可。

准备 Github 账户和远程仓库

1、前往Github 官网注册并登录一个 Github 账户。
2、点击右上角 + 号创建一个仓库

填写仓库信息。

SSH 密钥配置

1、首先在本地配置 Github 账户。
打开 Git Bash，输入以下命令：

git config --global user.name “用户名”
git config --global user.email "邮箱"

2、生成 SSH 密钥文件
继续输入命令：

ssh-keygen -t rsa -C "邮箱"

根据提示点击回车键三次出现以下内容即为创建 SSH 文件成功。

3、将公钥 id_rsa.pub 配置到 Github 账户

根据上面步骤创建的信息找到.ssh\id_rsa.pub 文件，使用记事本打开并复制里面的内容，打开 github 主页，进入个人设置 -> SSH and GPG keys -> New SSH key：

4、验证本地是否能通过 SSH 连接到 Github

Git Bash 输入命令：ssh -T git@github.com，按提示输入 yes 显示以下内容即证明 ssh 配置成功

Obsidian 安装插件 Git

在 Obsidian 笔记软件里进入设置 -> 第三方插件 -> 社区插件市场，点击浏览并搜索 "Git" , 点击安装并启用。

如果 Obsidian 侧边栏没有出现 Git Control View，可以按下 Ctrl + P，搜索并点击 Obsidian Git: Open Source Control View 即可出现。

插件的顶部按钮对应的一些 Git 常用操作：

Backup：备份，提交所有的更改，并且执行推送。

Commit：确认提交，但不推送。

Stage all：存储当前的变更。

Unstage all：取消存储变更。

Push：推送到远端，可以理解为推送到 Github。

Pull：从远端拉取到本地，可以理解为从 Github 拉取最新数据到本地。

Change Layout：改变下方文件的排布方式。

Refresh：刷新当前的文件变更情况。

Git 插件配置

1、打开 Obsidian，进入设置 -> 右侧边栏底部 第三方插件 -> Git。

根据需要配置备份间隔、自动拉取等选项，每次你做了更改，Git 会根据你设置的间隔自动备份，或者你可以点击工具栏上的 Git 图标手动备份。

将知识库笔记 Push 到远程仓库

1、先到 github 复制自己的 ssh 凭证

2、在知识库所在目录右键，选择Open Git Bash here

3、在终端输入以下命令：

git init //git 初始化
git add --all // 添加当前目录下的所以文件
git commit -m "first commit" // 提交日志
git remote add origin git@github.com/ZhouYingWiki.git // 这里替换成自己的库
git push -u origin master // 推送到远程仓库分支 master

显示以下信息即为推送成功

之后就可以直接在 Obsidian 笔记软件内使用 Git 插件推送同步了。

如何删除误同步的文件或者忽略某些文件？

删除 git 仓库上的目录和文件

1、可以看到我这里将.obsidian 和欢迎.md 全部误推送到仓库了，现在我要将它们从远程仓库删除。

删除远程目录
使用命令：==git rm -r --cached .obsidian==

删除远程文件
使用命令：==git rm 欢迎.md --cached==
2、提交更改并推送
git commit:

git push:

可以看到仓库上已经删除了相关文件和目录：

忽略不需要推送的目录和文件

1、在笔记目录下新建文本文件，改名为 ==.gitignore==，在文件中添加需要忽略的文件目录如：.obsidian
其他文件需要加斜杠”/ “才能识别。

这样在你之后的提交推送中都不会上传这些忽略的文件。