私はDropboxを使ってObsidianのノートを同期していましたが、Dropbox Basicプランを使用していたため、デバイス数に制限があり、AndroidスマートフォンではDropSync Appを使用してノートファイルを同期していました。しかし、Obsidian Gitプラグインが安定してきており、モバイルデバイス（Android、iOS、iPad）でもGitをローカルにインストールせずにGitリポジトリに直接アクセスできるようになったため、ストレージをクラウドドライブからGitクライアントに変更し始めました。以下は、異なる使用状況での操作手順です。

  1. ゼロからスタート：SandboxでGitとObsidianのシステムとリポジトリを構築する
  2. 既存のノートリポジトリにGit環境を追加してGitHubと同期する
  3. モバイルデバイスにGitプラグイン付きのObsidianをインストールして使用する
  4. その他のGit操作（.gitignoreを使用して同期しないフォルダやファイルを追加するなど）

リモートリポジトリにはGitHubを使用します。

通信プロトコル：https

モバイルデバイスでGitプラグインを使用する場合：リモートURLの通信プロトコルはHTTPSを使用し、SSHは使用しないでください

1. ゼロからスタート

1.1. GitHub設定

  1. GitHubアカウントを作成する
  2. アバターをクリック→【Settings】→左側の最後の項目【Developer Settings】→【Tokens (classic)】→【Generate new token】【Generate new token (classic)】
  3. 順番にデータを入力し、repoフィールドにチェックを入れ、一番下の【Generate token】をクリック
    1. 期限：デフォルトは30日ですが、無期限に変更可能
  4. 生成されたAccess tokenをコピーし、パスワード管理ツールに保存する

gh|700

▼ Fine-grained token を使用する場合、Contentsのアクセスを読み書き可能に変更する必要があります

gh|871

  1. 右上の【＋】マークをクリック→【New repository】をクリックしてGitリポジトリを作成し、名前を付けてPrivateにチェックを入れる→【Create repository】

gh|700

  1. HTTPSを選択し、URLをクリップボードにコピーする。URLの形式は：https://github.com/account/repo-name.git

gh|700

  1. ステップ6のHTTPS下の「creating a new file」をクリックし、任意の内容を入力して【Commit changes...】を押す
    gh|700

1.2. Sandbox操作

Windows/macOS Git Clientのインストール参考
  1. Windows obsidian-git-tut-windows (ステップバイステップの図解)
  2. macOS: Git on macOS

  1. [Git client](Git - Downloads)をダウンロードしてインストールする。Windowsのデフォルトインストール先は C:\Program Files\Git で、パスは自動的にPATH環境変数に追加されます。すべてデフォルト値のままで構いません

  2. Obsidianをダウンロードしてインストールする

  3. Obsidianを起動後、初期リポジトリを作成：Create→Vault nameに notes と入力し、Locationで C:\ を選択すると、リポジトリフォルダは C:\notes\ になります

  4. Obsidianで左側の歯車アイコン【Settings】→【Community plugins】→【Turn on community plugins】→【Browse】→Gitで検索→Gitを見つけたら【Install】→【Enable】をクリック

  5. Ctrl/Cmd+Pを押してコマンドパレットでcloneと入力し、Git: Clone an existing remote repositoryを実行

  6. ステップ1.1でコピーしたGitHub URLを貼り付けてEnterを押す

  7. リポジトリフォルダ名として personal-notes を入力してEnterを押す。Gitプラグインはデフォルトで既存のリポジトリフォルダ内にサブディレクトリを作成します（つまり C:\notes\personal-notes\）

  8. 必要なリポジトリの深さを入力し、Enterを押す

  9. GitHubへの接続ダイアログが表示されたら、Tokenをクリックし、ステップ1.1でコピーしたPersonal Access Tokenを貼り付けて【Sign in】をクリック

  10. Cloneが成功したらObsidianを再起動する

    gh|300

  11. 左下のリポジトリリストをクリック→【Manage vaults...】→Open、C:\notes\personal-notes を選択し、Git管理下のノートリポジトリを使用する

    gh|500

  12. 左側の歯車アイコン【Settings】→【Community plugins】→【Turn on community plugins】→【Browse】→Gitで検索→Gitを見つけたら【Install】→【Enable】→【Options】をクリック

    1. Auto commit-and-sync interval (minutes)：デフォルトは0ですが、同期したい間隔（分）に変更できます。例えば30など
    2. 下にスクロールしてAuthor name for commitとAuthor email for commitを見つけ、GitHubのアカウント名とEmailを入力

  13. 左側のツールバーに【Open Git source control】アイコンが表示されます。クリックすると右側にGit情報パネルが表示されます

  14. ローカルの変更は自動同期間隔内に自動的に同期されますが、Gitパネル上部のpullボタンを押してGitHubのファイルを取得したり、pushボタンを押してローカルで追加または変更した内容をGitHubにプッシュしたりすることもできます

gh|700

2. 既存のリポジトリにGit管理を追加する

  1. cmd.exeを再起動する
  2. コマンドプロンプトまたはターミナルで以下のコマンドを順番に実行する
git init
git add README.md
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/account/repo-name.git
git push -u origin main
  1. Obsidianを起動し、その後はステップ1.2の12番目以降の操作と同じです

3. モバイルデバイスにObsidianをインストールする

  1. USBケーブルでコンピュータとモバイルデバイスを接続し、ファイル転送を有効にする
  2. コンピュータ内のノートリポジトリフォルダをモバイルデバイスのルートディレクトリにコピーする
  3. Obsidianをインストールし、起動後、前のステップでコピーしたリポジトリフォルダを開く
  4. コマンドパレットを開いてGit pullを実行してテストする

2025/3/17 ViscousPot/GitSync: Android mobile git client for syncing a repository between remote and a local directory]] 🔗)

4. 発生する可能性のある問題

4.1. Windows: Obsidianが一定時間ごとにUsername、Passwordの入力プロンプトを表示する

デバッグ手順：

  1. 以下のコマンドを入力してGit Credential Managerが正しく設定されているか確認する
git config credential.helper

managerが返されない場合は、[Git client](Git - Downloading Package)の最新版を再インストールすることをお勧めします

参考

Installation - Git Documentation - Obsidian Publish

4.2. Windows: アカウントのアクセス権限の問題が発生する

ノートリポジトリフォルダを安全なディレクトリに追加してみてください：

git config --global --add safe.directory あなたのリポジトリフォルダ

5. 💡 関連リンク

💡 解説記事: https://jdev.tw/blog/8740/
💡 English: https://quaily.com/dashboard/lists/1588/posts/9360
💡 日本語: https://quaily.com/dashboard/lists/1589/posts/9361

✅ obsidian-git GitHub: https://github.com/Vinzent03/obsidian-git
✅ 参考 Getting started with Git: https://docs.github.com/en/get-started/learning-to-code/getting-started-with-git
✅ git-changelog GitHub: https://github.com/shumadrid/obsidian-git-changelog

✅ もう一つのGitプラグイン、Git clientのインストールが不要: github-gitless-sync GitHub: https://github.com/silvanocerza/github-gitless-sync

6. チュートリアル動画