Obsidian vault を git で壊さず運用するためのチェックリスト

Last updated at 2026-06-28Posted at 2026-06-28

Obsidian は Markdown ファイルをローカルフォルダに保存するため、git と相性がよいです。

ただし、vault には本文だけでなく .obsidian の設定、プラグイン状態、最近開いたファイルなども混ざります。
何を履歴に残すかを決めずに丸ごと同期すると、あとで復旧しにくくなります。

まず決めること

Markdown 本文を追跡する
.obsidian をどこまで追跡するか決める
端末固有の状態情報を追跡するか決める
Obsidian Sync と git の役割を分ける
plugin 更新前後で差分を見る

追跡対象の整理

対象	扱い	理由
Markdown notes	追跡する	知識本体
`.obsidian` の主要設定	条件付きで追跡する	端末間再現性に効く
Recent Files 状態	要判断	再開性には効くが端末依存もある
`.git`	Obsidian Sync では同期しない	git 自体の管理領域

`.obsidian` を扱うときの注意

.obsidian には hotkeys、themes、community plugins など vault 固有の設定が入ります。

別端末でも同じ環境を再現したいなら便利ですが、端末ごとの表示状態や一時状態まで巻き込みやすいです。

おすすめは、まず差分を見てから「再現性に必要なもの」と「ローカル状態でよいもの」を分けることです。
Obsidian公式ヘルプでも、頻繁に変わる .obsidian/workspace.json と .obsidian/workspaces.json は gitignore の候補として案内されています。

`obsidian-git` の使い方

obsidian-git は、Obsidian 上から commit / pull / push や履歴確認を扱える community plugin です。

見るポイントは次です。

自動 commit の間隔を短くしすぎない
起動時 auto-pull を使うなら衝突時の運用を決める
自動 push を使うならネットワーク失敗時の扱いを決める
plugin 更新前後で差分を見る

完璧に整理された文章だけを残すより、思考の節目が残る粒度を優先すると復旧しやすくなります。

Obsidian Sync と git の役割

Obsidian Sync は端末間同期と復元に強いです。
git は変更理由、差分レビュー、作業ログに強いです。

どちらか一方ですべてを満たそうとするより、役割を分けた方が安定します。

運用チェックリスト

vault 内に別 vault を作っていない
Markdown 本文は git 管理対象にする
.obsidian は再現性に必要なものだけ追う
.git と Obsidian Sync を同じ同期対象として扱わない
plugin 更新前後で差分を見る
自動 commit の間隔を短くしすぎない
復旧したい粒度で履歴が残っている

参考

確認日: 2026-06-28

note版: Obsidian を git で運用して知識ベースを壊さない方法

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up