使用 Obsidian 的 Git 插件将笔记同步到 GitHub 私有仓库

前置条件

在开始之前，请确保具备以下条件：

1. Obsidian 安装：已在电脑或移动设备上安装 Obsidian。
2. Git 安装：
   • Windows：从 git-scm.com 下载并安装。
   • Mac：使用 Homebrew 安装（brew install git）或从官网下载。
   • Linux：使用包管理器安装，例如 sudo apt-get install git（Debian/Ubuntu）。
3. GitHub 账号：已注册账号，建议启用双重认证。
4. 基本了解：对 GitHub 和 Obsidian 的基本操作有一定了解。

---

步骤一：创建 GitHub 私有仓库

1. 登录 GitHub：访问 github.com 并登录。
2. 创建新仓库：
   • 点击右上角 '+' 图标，选择 New repository。
   • 填写仓库名称，例如 Obsidian-Notes。
   • 选择 Private（私有仓库），确保笔记不公开。
   • 暂时不需要勾选 'Add a README file'。
   • 点击 Create repository。
3. 获取仓库地址：
   • 复制仓库的 HTTPS 或 SSH 地址（例如 https://github.com/你的用户名/Obsidian-Notes.git）。建议使用 HTTPS。

---

步骤二：生成 GitHub 个人访问令牌（PAT）

GitHub 不再支持密码认证，需使用 PAT 进行身份验证。

1. 进入设置：
   • 点击右上角头像，选择 Settings。
   • 左侧菜单点击 Developer settings。
2. 创建令牌：
   • 点击 Personal access tokens > Fine-grained tokens（推荐）或 Tokens (classic)。
   • 点击 Generate new token。
   • Fine-grained token：命名令牌，设置过期时间，选择仅特定仓库访问，启用 Contents（读写权限）。
   • Classic token：勾选 repo 权限。
   • 点击 Generate token。
3. 保存令牌：
   • 复制生成的令牌并妥善保存（仅显示一次），建议存储在密码管理器中。

---

步骤三：初始化本地 Obsidian 仓库

1. 选择或创建 Vault：
   • 打开 Obsidian，选择笔记文件夹。假设路径为 ~/Obsidian-Notes。