ObsidianをGitで同期する【2026年8月版】衝突も怖くない

目次 / INDEX

Obsidianの同期を無料で済ませる方法はいくつかあるが、その中でGitだけが持っている強みが履歴だ。「先週消したあの段落を復元する」「レポートの3日前の版と見比べる」が、同期のついでにできる。公式Obsidian Syncの月額を払わずに、履歴も残したい。コマンドに抵抗がないなら、Gitはその両方を満たす。

無料の同期方法4つの比較はObsidianを無料で同期するにまとめた。この記事はその中のGitの深掘りだ。比較は向こうに任せ、こちらは「Gitでやると決めた人」のために、セットアップからコンフリクト（衝突）が起きたときの直し方まで具体的に書く。解説記事の多くは繋ぎ方で終わるが、実際に困るのは衝突したときだからだ。

結論 リポジトリは**必ず非公開（private）**で作る。日々の運用はプラグインに任せてよいが、衝突したら手動で直すと最初から決めておく。衝突してもノートは消えない——両方の内容がファイルに残り、選ぶのは自分だ。この一点を知っているだけで、Git同期の怖さはほとんど消える。

仕組みの前に：用語は5つだけ

Gitの用語は多いが、同期に使うだけなら5つで足りる。それぞれ一言に言い換えておく。

用語	一言でいうと
リポジトリ	履歴ごと入った保管場所。Vaultのフォルダがそのままなる
コミット	変更の記録。「この時点」として名前を付けて保存する操作
push（プッシュ）	手元の記録をGitHub（ネット上の置き場）へ送る
pull（プル）	GitHubにある最新の記録を手元へ取り込む
コンフリクト（衝突）	2つの端末が同じ場所を別々に変えてしまい、Gitが「どちらを残すか」を決められない状態

同期の正体は単純で、端末Aでコミットしてpush、端末Bでpullする——この繰り返しだ。クラウドストレージと違い、途中の状態が全部「変更の記録」として残るから、履歴が付いてくる。Git自体の基礎は大学生のためのGit・GitHub入門にまとめている。

リポジトリは必ず非公開（private）にする

手順の前に、ここだけ先に書く。GitHubにリポジトリを作るとき、公開（public）と非公開（private）を選べる。Vaultは必ずprivateにする。理由は2つ。

1. publicは全世界に公開される。 授業メモのつもりでも、日記や人間関係のメモが混ざるのがノートアプリだ。「見られて困るものは書いてない」は、書き続けるうちに崩れる
2. .obsidian フォルダに認証情報が入ることがある。 プラグインによっては接続先のトークン（合鍵にあたる文字列）が設定ファイルに保存される。公開すればそれも漏れる

2026年8月時点で、GitHubの無料プランでもprivateリポジトリは作れる（条件は変わりうるので公式ページで確認を）。無料だからpublicにする理由はない。

セットアップ手順（パソコン側）

前提として、Gitのインストールと、GitHubのアカウント作成・認証（パスワードではなくPersonal Access TokenかSSH鍵を使う）は済んでいるとする。⚠️ そして作業前にVault全体を別の場所へコピーしておくこと。どの同期方法でも、事故がいちばん起きるのは初回接続だ。

1. VaultをGitリポジトリにする

ターミナルでVaultのフォルダへ移動し、リポジトリとして初期化する。

cd ~/Documents/MyVault   # 自分のVaultの場所に置き換える
git init

2. 同期しないファイルを決める（.gitignore）

Vault直下に .gitignore というファイルを作り、記録の対象から外すものを書く。ウィンドウ配置のような端末ごとに違って当然のファイルを外すと、無用な衝突がかなり減る。

.obsidian/workspace.json
.obsidian/workspace-mobile.json
.trash/
.DS_Store

⚠️ .obsidian を丸ごと外す例も見かけるが、それだとプラグインやテンプレートの設定が端末間で揃わなくなる。丸ごとではなく、端末固有のファイルだけを外すのが基本だ。認証情報を保存するプラグインを使っているなら、そのデータファイルもここに足す。

3. 最初のコミットとpush

git add .
git commit -m "初回コミット"

次にGitHubのサイト側でprivateの空リポジトリを作り（READMEの自動作成はオフにする）、表示されるURLを使って接続・送信する。

git remote add origin https://github.com/ユーザー名/リポジトリ名.git
git branch -M main
git push -u origin main

これで手元のVaultがGitHubに上がった。2台目の端末では、逆にGitHubから取ってくる。

git clone https://github.com/ユーザー名/リポジトリ名.git

できたフォルダをObsidianで「保管庫として開く」だけで、2台目の準備は終わりだ。

日々の運用はプラグインに任せる

毎回ターミナルを開いてもいいが、**コミュニティプラグインのGit（旧称 Obsidian Git）**を入れると、Obsidianの中からコミット・push・pullを実行できる。定期的な自動コミットと送受信、起動時のpullも設定でき、日常の同期はほぼ自動化できる。

運用の型は、開いたらまずpull（起動時の自動pullをオン）→ 普通に書く → 閉じる前にコミットしてpush。衝突を減らすコツは端末を移るときに前の端末のpushを済ませておくことで、これを守っている限り衝突はめったに起きない。

⚠️ 自動コミットの間隔を数分単位まで詰めると、履歴が「auto backup」だらけになって読みにくくなる。迷ったら間隔は長めから始めるといい。

コンフリクト（衝突）が起きたときの直し方

本題だ。pullしたときに次のような表示が出たら、衝突が起きている。

CONFLICT (content): Merge conflict in 講義ノート.md
Automatic merge failed; fix conflicts and then commit the result.

まず落ち着いてほしい。この時点でノートは1文字も消えていない。Gitは決められなかっただけで、両方の内容をファイルの中に残している。

1. 何が衝突したかを確認する

git status

「both modified」と表示されたファイルが衝突しているノートだ。

2. ノートを開いて、目印を探す

衝突したノートをObsidianかテキストエディタで開くと、こういう目印（コンフリクトマーカー）が入っている。

<<<<<<< HEAD
この端末で書いた内容
=======
もう一方の端末で書いた内容
>>>>>>> （相手側の記録の名前）

<<<<<<< から ======= までがこの端末の版、======= から >>>>>>> までが相手側の版だ。

3. 残す内容を決めて、目印を消す

やることは編集だけだ。残したい行を残し、要らない行と3種類の目印の行を全部削除する。両方残したければ両方書けばいい。正解を選ぶのはGitではなく自分、というのがここの本質だ。

4. 解消をコミットしてpushする

git add 講義ノート.md
git commit -m "衝突を解消"
git push

これで完了だ。慣れれば数分の作業で、ノートを失うことはない。

途中でやめたくなったら

編集がこんがらがったら、いったん全部なかったことにできる。

git merge --abort

pullする前の状態に戻るので、深呼吸してからやり直せばいい。逃げ道があると知っていることが、Git同期を怖くなくする一番の材料だと思う。

⚠️ Gitプラグイン経由で同期していて衝突した場合も、仕組みは同じだ。プラグインが衝突ファイルの一覧を示してくれるので、ノートを開いて目印を消し、コミットし直せばいい。マーカーの入ったままのノートを放置しないこと。放置するとその目印ごと「本文」としてコミットされてしまう。

モバイル（iOS・Android）の制約

ここはGit同期の弱点なので、正直に書く。

• ObsidianのGitプラグインはモバイルでも動くが、パソコン版とは別の仕組みで動いており、制約がある。 大きいVaultで遅い・メモリを食う、SSHでの接続ができない（HTTPSとトークンを使う）、使えない機能があるなど、プラグインのドキュメント自体が制限を明記している（2026年8月時点。最新はドキュメントで確認してほしい）
• iPhoneでは、Working Copyという別のGitアプリでpull・pushを行い、そのフォルダをObsidianで開く構成が定番だ。ただしアプリの一部機能は有料で、設定の手数も増える
• Androidでは、Termuxなどの端末アプリにGitを入れて操作する方法があるが、これは「スマホでコマンドを打つ」世界で、人を選ぶ

つまりGit同期はパソコンが主役の人向けだ。スマホでの利用が閲覧と軽いメモ程度ならプラグインの範囲で足りるが、スマホでがっつり編集するなら、モバイルに強い方法を含めて比較記事から選び直すほうがいい。

⚠️ その他の注意点

⚠️ 大きなバイナリファイルには向かない。 Gitはテキストの差分管理が得意で、画像・PDF・音声は苦手だ。GitHubは1ファイル100MBを超えるとpushを拒否するし、重い添付が増えるほどリポジトリが膨らんで遅くなる。動画を貼るようなVaultなら設計から考え直したい。

⚠️ 同期していてもバックアップにはならない。 履歴から過去の版を復元できるのはGitの強みだが、その履歴ごとGitHubのアカウントに依存している。アカウントにアクセスできなくなれば、リモート側は使えなくなる。同期とは別に、Vault全体を別の媒体へ定期的にコピーしておく——具体的なやり方はObsidianのバックアップにまとめた。

⚠️ 「2026年8月時点」を前提に読む。 GitHubの無料プランの条件、プラグインの名称や対応範囲は変わりうる。始める前に、GitHubの料金ページとプラグインのドキュメントで最新の記述を確認してほしい。

今日の要点

• Gitは無料同期の中で同期と履歴が同時に手に入る方法。比較は比較記事、この記事は手順の深掘り
• リポジトリは必ずprivate。ノートの中身と、.obsidian に入りうる認証情報を守るため
• .gitignore では端末固有のファイルだけを外す。.obsidian 丸ごと除外は設定が揃わなくなる
• 日々の運用はGitプラグインで自動化し、端末を移る前にpushを習慣にする
• 衝突してもノートは消えない。残す行を選んで目印を消し、コミットし直す。困ったら git merge --abort で衝突前に戻れる
• モバイルは制約が多く、Git同期はパソコン主体の人向け
• 履歴はバックアップの代わりにならない。別媒体へのコピーはバックアップ記事の手順で

まずはテスト用の小さなVaultで、一度わざと衝突を起こして直してみてほしい。本番で初めて遭遇するより、ずっと気楽に習得できるはずだ。