準備階段 第 1 步 / 共 19 步
📱

Obsidian iPhone + Mac + GitHub
三方同步懶人包

把你的 Obsidian vault 在 Mac、iPhone、GitHub 三邊同步

📱 主要在 iPhone 上操作
⏱️ 第一次大約 10-30 分鐘(看你起點)
💰 完全免費(不用付 iCloud / Obsidian Sync / Working Copy)

你會用到的 2 個 app:
  • 🟣 Obsidian(免費)— 主編輯器
  • 🟢 GitSync.md(免費版 1 repo 額度)— iPhone 上的 git 客戶端
先選你的起點 ↓

三種情境,選一個進入對應流程:

⌨️ 進階:拍攝/錄影者F 切拍攝模式,J/K 切換步驟,? 看快捷鍵
階段 0 — 申請 GitHub 帳號

打開 Safari,到 github.com

1. 解鎖 iPhone,打開內建的 Safari 瀏覽器

2. 上方網址列輸入:github.com

3. 進入 GitHub 首頁(黑底白字、可能會看到 Octocat 章魚貓圖案)

你會看到
黑色背景的頁面,右上角有「Sign in」跟「Sign up」兩個按鈕。

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 0 — 申請 GitHub 帳號

點右上角 Sign up,用 email 註冊

1. 點右上角的 Sign up 按鈕

2. 輸入你的 email(GitHub 會寄驗證信過來)

3. 設定密碼(建議用密碼管理器或寫下來)

4. 取一個 Username(英文+數字,例如 tom-doe

5. 完成驗證題(有時會有圖片驗證)

⚠️ 重要
Username 取了就不容易改,建議用簡單好記的英文 + 數字組合。

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 0 — 申請 GitHub 帳號

驗證 email + 完成帳號設定

1. 去你的 email 信箱 找 GitHub 寄來的驗證信

2. 點信裡的 Verify email address 連結

3. 看到「Email verified」就成功了

4. 完成 GitHub 的引導頁(選 Free Plan、跳過或填基本資料)

💡 接下來
回到 GitHub 首頁,準備在下一階段建你自己的 vault repo。

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 0 — 建你的 vault repo

建一個 private repo 放你的 vault

1. GitHub 主畫面右上 ➕ → New repository

2. Repository name:填一個英文名(例如 my-vaultsecond-brain

3. Description:可選

4. ⚠️ 一定要選 Private(私人筆記不要 Public)

5. ✅ 勾 Add a README file(讓 repo 有初始 commit,等下 clone 才不會出錯)

6. 最下面點 Create repository

記住這個 repo 名
等下 GitSync 要選 repo 時要用,例如:你的 username/my-vault

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 1 — 安裝 App(先裝這個)

App Store 裝 Obsidian

Obsidian icon
Obsidian Dynalist Inc. 👆 點此直接打開 App Store

1. 點上方卡片下載(或自己在 App Store 搜尋 Obsidian

2. 認對:icon 是紫色寶石,開發者「Dynalist Inc.」

3. 「取得」→ Face ID 確認 → 等下載完

4. 打開 Obsidian 一次(看到歡迎畫面就好,不用點任何東西)

5. 退回主畫面

⚠️ 為什麼要先開一次
Obsidian 第一次打開會在 iPhone 建立它的專屬資料夾,等下 GitSync 要把資料搬過去時才找得到

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 1 — 安裝 App(再裝這個)

App Store 裝 GitSync

GitSync.md icon
GitSync.md Cody Russell Bontecou 👆 點此直接打開 App Store
⚠️ App Store 有另一個叫「GitSync」的,別裝錯
那個是 ViscousPot/GitSync(開源、Android+iOS),功能類似但沒有跟 Obsidian Git plugin 緊密整合

認對我們要的這個:
✅ 名字尾巴有「.md
✅ 開發者顯示 Cody Russell Bontecou
✅ icon 是綠色(不是 ViscousPot 那個淺色)

1. 點上方卡片下載(或自己搜尋 GitSync.md,注意要含 .md 後綴)

2. 認對:開發者「Cody Russell Bontecou」

3. 「取得」→ Face ID 確認 → 等下載完

4. 回主畫面確認兩個 icon 都在:🟣 Obsidian + 🟢 GitSync

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 2 — 連到 GitHub

打開 GitSync → Sign in with GitHub

1. 點主畫面的 🟢 GitSync icon 打開

2. 看到歡迎畫面(全英文,不用慌)

3. 中間有個按鈕 Sign in with GitHub → 點它

4. iPhone 內建瀏覽器跳出 GitHub 登入頁

你會看到
從 GitSync app 跳到一個 GitHub.com 的登入頁,要你輸入 email/password。

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 2 — 連到 GitHub

登入 GitHub → Authorize

1. 輸入 GitHub email + 密碼登入

2. 如果你有設 2FA 驗證碼,輸入

3. 跳到 「Authorize GitSync.md」 頁面

4. 下面有一堆權限說明(不用細看)

5. 點綠色 Authorize 按鈕

6. 自動跳回 GitSync app,看到你的 repo 列表

💡 這個授權就是告訴 GitHub:「GitSync 可以幫我拿資料」

跟「用 Google 登入網站」是一樣的事,不是把密碼給人。

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 3 — 下載資料

選 <your-repo> 這個資料夾

1. GitSync 主畫面找 Add RepositoryPick from GitHub 按鈕

2. 點它,跳出你能存取的 repo 列表

3. 找 <your-repo> → 點它

⚠️ 看不到 <your-repo>?
可能是邀請還沒接受 — 回階段 0 第 4 步檢查 email。

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 3 — 下載資料

Save 位置先隨便選沒關係

GitSync 跳出 Files picker 問你「存到哪」。

💡 不用糾結這一步 — 隨便選 On My iPhone 任何位置,直接「Save / 完成」就好。

等下我會教你更可靠的搬家方法,比在這裡瞎選資料夾穩多了。

最簡單的做法
1. 上方點「On My iPhone
2. 直接右下「Save / 完成
3. GitSync 開始下載

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 3 — 下載資料

等下載完成

GitSync 開始下載,畫面顯示 「Cloning...」 進度條。

⏱️ 大約 30 秒 - 2 分鐘,看 wifi 速度

完成後會看到:

  • ✅ 綠色勾勾
  • 或文字「Clone complete」
  • 或 repo 出現在 GitSync 主畫面列表

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 4 — ⭐ 關鍵搬家步驟

在 GitSync 內把 Repo 搬到 Obsidian 資料夾

這是整個流程最重要的一步。前面 Save 位置不對沒關係,這裡正規搬一次就對。

  1. 回到 🟢 GitSync app
  2. <your-repo> repo 進入詳情
  3. 找右上角 ⚙️ Settings(齒輪圖示)
  4. 進設定頁,往下捲找 Storage 區塊
  5. Move Vault(搬家)
  6. 跳出 Files picker → 選 On My iPhone → Obsidian
  7. 右上「Move / 完成

GitSync 會把 repo 整個搬到 Obsidian 的專屬資料夾。

💡 為什麼用 Move Vault 而不是手動搬
GitSync 自己知道 .git 資料夾、檔案 metadata 等都要一起搬,不會搬一半。手動拖比較容易少東西。

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 4 — 驗證

用「檔案」App 確認搬好了

1. 回 iPhone 主畫面,打開藍色 「檔案」 app

2. 左下「瀏覽」→「On My iPhone

3. 進入 Obsidian 資料夾

4. 應該看到 <your-repo> 子資料夾

5. 進去看到一堆 .md 檔 → 成功 ✅

正確路徑
On My iPhone → Obsidian → <your-repo> → 一堆 .md 檔

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 5 — Obsidian 開啟知識庫

打開 Obsidian → Open folder as vault

1. 主畫面點 🟣 Obsidian icon

2. 第一次開會看到歡迎畫面

3. 找按鈕 Open folder as vault(打開資料夾當作 vault)→ 點它

4. 跳出檔案選擇器

你會看到
紫色背景的歡迎畫面,中間有 2-3 個按鈕:「Create new vault」、「Open folder as vault」、「Connect to Obsidian Sync」。選中間那個

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 5 — Obsidian 開啟知識庫

選資料夾 → Trust

檔案選擇器跳出來:

  1. 上方「瀏覽」→「On My iPhone
  2. 進入 Obsidian 資料夾
  3. 看到 <your-repo>
  4. 點選它(不用進去)
  5. 右上 Open
  6. 跳「Trust this vault?」 → 點 Trust

左邊欄會出現很多資料夾跟檔案 — 這就是小安整理的知識庫

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 6 — 切換成繁體中文

把 Obsidian 介面切繁中

英文看不慣?把 Obsidian 切繁中:

  1. Obsidian 左下角 ⚙️ 設定 圖示
  2. 找「About」區塊
  3. Language」→ 下拉選「繁體中文 (Traditional Chinese)
  4. 按提示重啟 Obsidian
  5. 重開 → 整個介面變繁中 ✅
⚠️ GitSync 沒辦法切繁中
但你只要記得 4 個英文字夠用:
Pull = 拉新內容(最常用)
Sync = 同步
Open = 打開
Trust = 信任

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

階段 7 — 學會「拉新內容」

小安寫了新東西,怎麼拉到 iPhone?

每天要做一次(或想看最新時):

  1. 打開 🟢 GitSync app
  2. <your-repo> repo
  3. PullSync 按鈕
  4. 等 10-30 秒拉新內容
  5. 回 🟣 Obsidian → 內容自動更新

🚫 你不用做的事:

  • 不用 Push(這是寫入,你只看不寫)
  • 不用 Commit
  • 不用設認證 token
  • 不用碰任何進階設定

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 N 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

進階(可選) — 解鎖雙向編輯

想在 iPhone 也能寫筆記 push 回 GitHub?

誰該選這條路:

  • 你想在 iPhone 上隨手寫筆記,自動同步回 GitHub(雙向)
  • 你熟悉 GitHub、不怕碰 token
  • 想要 10 分鐘自動 sync,不用每次手動按 Pull

純讀夠用?直接按下面綠色「跳過」到完成頁。90% 客戶不需要這條路。

進階流程(約 10 分鐘):
  1. Mac Safari 開 github.com/settings/tokens/new
  2. Generate new token → classic
  3. Note 填 Obsidian iOS;Scopes 勾整個 repo;Expiration 設 No expiration
  4. Generate → 複製 ghp_xxxxx 字串
  5. iMessage / Notes 把這串傳到 iPhone
  6. iPhone Obsidian → ⚙️ Settings → Community plugins → Browse
  7. 搜「Obsidian Git」by Vinzent → Install → Enable
  8. Settings → Obsidian Git → 填 GitHub username + email
  9. 第一次 Commit-and-sync 跳 prompt 時貼上 PAT
  10. 同頁設 Vault backup interval = 10(10 分鐘自動 commit+push)
⚠️ PAT 是強密碼級別
泄露等於別人能改你整個 repo。設好後存進 1Password 等密碼管理器。

第一次同步可能 conflict(兩端 .obsidian/workspace.json 打架),看 GitSync 或 Obsidian 介面提示處理。

📸 先截圖這頁畫面
同時按側邊鍵 + 提高音量鍵

點下會複製「卡在第 18 步:步驟名」到剪貼簿 + 連到 GitSync 官方文件

完成 ✨
🎉

恭喜,全部搞定!

小安的知識庫已經在你 iPhone 上跑起來了。

從現在開始,每天打開 Obsidian 就能看到小安幫你整理的內容。

🎉 你做到了!
從現在開始,每天打開 Obsidian 就能看到跨裝置同步的內容。
未來如果搞砸了?
別怕 — 資料在 GitHub 雲端是安全的,iPhone 端弄壞了砍掉重 clone 就好,5 分鐘恢復。
每張 slide 的「⚠️ 我卡住了」按鈕會幫你複製錯誤訊息,貼到 Google / ChatGPT 問即可。