Obsidian でノートを取り続けていると、いつの間にか大切な情報が消えてしまったり、誤って上書きしてしまったりした経験はありませんか。そんなときに心強い味方となるのが Obsidian Git プラグインです。このプラグインを導入すれば、ノートの変更履歴を自動的に記録し、いつでも過去の状態に戻せるようになります。

本記事では、Obsidian Git プラグインの導入から、自動コミット設定、差分プレビュー、そして誤って削除したノートの復旧まで、実際の操作画面を交えながら丁寧に解説いたします。Git の知識がない方でも安心して導入できる内容となっていますので、ぜひ最後までお読みください。

背景

Obsidian におけるバージョン管理の必要性

Obsidian は、マークダウン形式でノートを管理する強力なナレッジベースツールです。日々の思考やアイデアを記録し続けることで、貴重な知的資産が蓄積されていきますね。

しかし、このような重要なデータを扱う際には、以下のようなリスクが常に存在します。

• ノートを誤って削除してしまう
• 重要な内容を上書きして元に戻せない
• いつ、どのような変更を加えたか追跡できない
• 複数デバイス間での同期時にコンフリクトが発生する

これらの課題を解決するためには、バージョン管理システムの導入が有効です。

Git によるバージョン管理の仕組み

Git は、ソフトウェア開発の現場で広く使われているバージョン管理システムです。ファイルの変更履歴を時系列で記録し、必要に応じて過去の状態に戻せるのが特徴ですね。

以下の図は、Obsidian のノートを Git で管理する基本的なフローを示しています。

mermaidCopy codeflowchart TB
    user["ユーザー"] -->|"ノート編集"| vault["Obsidian Vault<br/>(.md ファイル)"]
    vault -->|"変更検知"| plugin["Obsidian Git<br/>プラグイン"]
    plugin -->|"自動 commit"| local["ローカル<br/>Git リポジトリ"]
    local -->|"push"| remote["リモート<br/>リポジトリ<br/>(GitHub など)"]
    remote -->|"pull"| local
    local -->|"復旧・差分確認"| vault

図で理解できる要点：

• ノートの編集内容はプラグインが自動的に検知します
• 定期的にローカルリポジトリへコミットされます
• リモートリポジトリと同期することでバックアップも実現できます

Obsidian Git プラグインの役割

Obsidian Git プラグインは、Git の複雑なコマンド操作を自動化し、Obsidian 上で簡単にバージョン管理を実現するツールです。通常、Git を使うにはコマンドラインでの操作が必要ですが、このプラグインを使えば GUI 上で直感的に操作できるようになります。

主な機能として、以下のようなものがあります。

#	機能	説明
1	自動コミット	指定した間隔で自動的に変更を記録
2	差分プレビュー	変更箇所を視覚的に確認
3	バックアップ	リモートリポジトリへの自動プッシュ
4	復旧機能	過去の状態への復元
5	コンフリクト解決	同期時の衝突を検知・解決

これらの機能により、技術的な知識がなくても安全にノートを管理できるようになるんです。

課題

バージョン管理を導入しない場合のリスク

Obsidian をバージョン管理なしで運用すると、以下のような深刻な問題に直面する可能性があります。

まず、データ損失のリスクが挙げられます。誤操作でノートを削除してしまった場合、通常は復旧する手段がありません。特に、長時間かけて作成した重要なドキュメントが一瞬で消えてしまうと、精神的なダメージも大きいですね。

次に、変更履歴の不透明さも問題です。「先週のバージョンではどう書いていたか」を確認したくても、過去の状態を参照する方法がないため、記憶に頼るしかなくなってしまいます。

さらに、複数デバイス間での同期トラブルも頻発します。iCloud や Dropbox で同期している場合、同じファイルを異なるデバイスで編集すると、コンフリクトが発生して内容が失われることがあるんです。

Git 導入時の技術的なハードル

一方で、Git を直接使おうとすると、初心者にとっては以下のような障壁があります。

コマンドライン操作の難しさは、多くの方が最初につまずくポイントです。git add、git commit、git push といったコマンドを覚え、ターミナルで正確に入力する必要がありますね。

bashCopy code# 従来の Git 操作（コマンドライン）
cd /path/to/obsidian-vault
git add .
git commit -m "ノートを更新"
git push origin main

上記のようなコマンドを毎回手動で実行するのは、かなり面倒です。

また、Git の概念理解も必要になります。リポジトリ、コミット、ブランチ、プッシュ、プルといった用語を理解し、適切に使い分けなければなりません。

以下の図は、Git の基本的な状態遷移を示しています。

mermaidCopy codestateDiagram-v2
    [*] --> WorkingDir: ファイル編集
    WorkingDir --> StagingArea: git add
    StagingArea --> LocalRepo: git commit
    LocalRepo --> RemoteRepo: git push
    RemoteRepo --> LocalRepo: git pull
    LocalRepo --> WorkingDir: git checkout

図で理解できる要点：

• ファイルは複数の状態を経てリモートリポジトリに反映されます
• 各ステップで適切なコマンドを実行する必要があります
• この複雑さが初心者の導入障壁となっています

自動化と手動管理のバランス

バージョン管理を実現するには、適切な自動化が必要です。しかし、すべてを自動化すると以下のような問題も生じます。

過剰なコミット履歴が蓄積されると、後から特定の変更を見つけにくくなります。例えば、1 文字修正しただけでコミットが作られると、履歴が煩雑になってしまうんですね。

また、意図しない変更の記録も課題です。一時的なメモや、公開したくない個人情報が誤ってコミットされてしまうリスクがあります。

このため、自動化の設定と手動での調整を適切に組み合わせることが重要になります。

解決策

Obsidian Git プラグインによる自動化

Obsidian Git プラグインは、前述の課題を解決するために設計されています。コマンドライン操作を一切必要とせず、Obsidian の設定画面から簡単に Git を管理できるんです。

以下の図は、プラグイン導入後のワークフローを示しています。

mermaidCopy codeflowchart LR
    edit["ノート編集"] --> auto["自動検知<br/>(設定時間)"]
    auto --> commit["自動 commit"]
    commit --> push["自動 push<br/>(オプション)"]
    push --> safe["安全に保存"]

    edit -.->|"手動確認"| diff["差分<br/>プレビュー"]
    diff -.-> manual["手動 commit"]
    manual --> push

図で理解できる要点：

• 編集後、設定した時間が経過すると自動でコミットされます
• 手動で差分を確認してからコミットすることもできます
• 柔軟な運用が可能な設計になっています

プラグインの主要機能

Obsidian Git プラグインには、以下の機能が搭載されています。

自動コミット機能

指定した間隔（例：5 分ごと）で自動的に変更をコミットします。コミットメッセージも自動生成されるため、手間がかかりません。

差分プレビュー機能

変更箇所を視覚的に確認できる機能です。どのファイルが、どのように変更されたかが一目でわかりますね。

バックアップ機能

ローカルリポジトリの内容を GitHub などのリモートリポジトリへ自動的にプッシュできます。これにより、PC の故障やデータ破損に備えられます。

復旧機能

過去のコミットから特定の時点のノートを復元できます。誤って削除したファイルや、上書きしてしまった内容を簡単に取り戻せるんです。

導入のメリット

Obsidian Git プラグインを導入することで、以下のメリットが得られます。

#	メリット	詳細
1	データ保護	誤削除や上書きから大切なノートを守れる
2	変更追跡	いつ、何を変更したか明確に把握できる
3	複数デバイス対応	安全に複数の PC やスマホで同期できる
4	学習コスト低減	Git のコマンドを覚える必要がない
5	無料で利用可能	オープンソースで完全に無料

特に、データ保護と学習コスト低減の両立が、このプラグインの最大の価値と言えるでしょう。

具体例

ここからは、実際に Obsidian Git プラグインを導入し、設定する手順を段階的に解説します。初めて Git に触れる方でも安心して進められるよう、各ステップを詳しく説明いたしますね。

事前準備

Git のインストール

まず、お使いの PC に Git がインストールされている必要があります。以下のコマンドで確認してみましょう。

bashCopy codegit --version

上記のコマンドを実行して、バージョン番号が表示されれば Git はインストール済みです。

表示されない場合は、公式サイトから Git をインストールしてください。

bashCopy code# macOS の場合（Homebrew 使用）
brew install git

# Windows の場合は公式サイトからインストーラーをダウンロード
# https://git-scm.com/download/win

GitHub アカウントの作成（推奨）

リモートバックアップを利用する場合は、GitHub アカウントが必要です。GitHub 公式サイトから無料でアカウントを作成できます。

アカウント作成後、新しいプライベートリポジトリを作成しておきましょう。リポジトリ名は「obsidian-vault」などわかりやすい名前がおすすめです。

プラグインのインストール

コミュニティプラグインの有効化

Obsidian でコミュニティプラグインを使用するには、まず設定で有効化する必要があります。

以下の手順で進めてください。

1. Obsidian を起動し、設定画面を開く（歯車アイコン）
2. 左サイドバーから「コミュニティプラグイン」を選択
3. 「セーフモードをオフにする」をクリック

これで、サードパーティ製のプラグインがインストールできるようになります。

Obsidian Git プラグインの検索とインストール

次に、Obsidian Git プラグインをインストールします。

1. 「コミュニティプラグイン」画面で「閲覧」ボタンをクリック
2. 検索ボックスに「Obsidian Git」と入力
3. 表示された「Obsidian Git」プラグインを選択
4. 「インストール」ボタンをクリック
5. インストール完了後、「有効化」ボタンをクリック

これで、Obsidian Git プラグインが使用可能になりました。

Git リポジトリの初期化

ローカルリポジトリの作成

プラグインを有効化したら、Obsidian Vault を Git リポジトリとして初期化します。

以下の手順で実行してください。

1. Obsidian の左サイドバーにあるコマンドパレットを開く（Cmd + P または Ctrl + P）
2. 「Obsidian Git: Initialize」と入力
3. コマンドを実行すると、Vault のルートディレクトリに .git フォルダが作成される

これで、ローカルでのバージョン管理が開始されます。

.gitignore ファイルの設定

すべてのファイルをバージョン管理する必要はありません。以下のようなファイルは除外するのが一般的です。

bashCopy code# Obsidian の設定ファイル（個人設定）
.obsidian/workspace.json
.obsidian/workspace-mobile.json

# プラグインキャッシュ
.obsidian/plugins/*/

# 一時ファイル
.DS_Store
.trash/

上記の内容を .gitignore ファイルとして Vault のルートに保存します。これにより、不要なファイルがコミットされるのを防げるんです。

Vault のルートディレクトリに .gitignore ファイルを作成し、以下の内容を記述してください。

gitignoreCopy code# Obsidian 個人設定
.obsidian/workspace.json
.obsidian/workspace-mobile.json

# システムファイル
.DS_Store
.trash/

自動コミットの設定

設定画面へのアクセス

Obsidian の設定画面から、Obsidian Git プラグインの設定を開きます。

1. 設定画面（歯車アイコン）を開く
2. 左サイドバーの「コミュニティプラグイン」セクションから「Obsidian Git」を選択

ここで、自動コミットに関する詳細な設定が行えます。

自動コミット間隔の設定

自動コミットの間隔を設定します。デフォルトは無効になっているため、有効化する必要があります。

typescriptCopy code// 設定例（プラグイン内部の設定イメージ）
{
  "autoSaveInterval": 5,  // 5分ごとに自動保存
  "autoCommitMessage": "vault backup: {{date}}"  // コミットメッセージの形式
}

推奨設定は以下の通りです。

#	設定項目	推奨値	説明
1	Vault backup interval	5-10 分	編集頻度に応じて調整
2	Auto commit message	vault backup: {{date}}	日時を自動挿入
3	Commit on file change	オフ	過剰なコミットを防ぐ

「Vault backup interval (minutes)」に 5 と入力すると、5 分ごとに自動でコミットされるようになります。

コミットメッセージのカスタマイズ

自動コミットのメッセージは、以下の変数を使ってカスタマイズできます。

bashCopy code{{date}}      # 現在の日時（例: 2025-11-15 14:30:00）
{{hostname}}  # PC のホスト名
{{numFiles}}  # 変更されたファイル数

例えば、以下のように設定できます。

bashCopy codevault backup: {{date}} - {{numFiles}} files changed

このようにすることで、コミット履歴から変更内容を把握しやすくなりますね。

リモートリポジトリとの連携

GitHub リポジトリとの接続

ローカルで管理しているリポジトリを、GitHub と連携させます。これにより、クラウドバックアップが実現できるんです。

まず、GitHub で作成したリポジトリの URL をコピーしておきます（例: https:​/​​/​github.com​/​username​/​obsidian-vault.git）。

次に、以下のコマンドをターミナルで実行します。

bashCopy code# Vault のディレクトリに移動
cd /path/to/your/obsidian-vault

リモートリポジトリを追加します。

bashCopy code# リモートリポジトリを origin として登録
git remote add origin https://github.com/username/obsidian-vault.git

初回のプッシュを実行します。

bashCopy code# main ブランチを作成してプッシュ
git branch -M main
git push -u origin main

これで、ローカルの変更が GitHub に反映されるようになりました。

自動プッシュの有効化

Obsidian Git プラグインの設定で、自動プッシュを有効化できます。

1. プラグイン設定画面を開く
2. 「Auto push on commit」をオンにする
3. 「Pull updates on startup」をオンにする（起動時に最新版を取得）

これらの設定により、以下のような動作になります。

mermaidCopy codesequenceDiagram
    participant User as ユーザー
    participant Vault as Vault
    participant Plugin as プラグイン
    participant GitHub as GitHub

    User->>Vault: ノート編集
    Note over Vault,Plugin: 5分経過
    Plugin->>Vault: 変更検知
    Plugin->>Vault: 自動 commit
    Plugin->>GitHub: 自動 push
    GitHub-->>Plugin: 完了通知

    Note over User,GitHub: 次回起動時
    User->>Plugin: Obsidian 起動
    Plugin->>GitHub: pull request
    GitHub-->>Vault: 最新版取得

図で理解できる要点：

• 編集後、一定時間でコミットとプッシュが自動実行されます
• 起動時には最新版を自動取得します
• 複数デバイス間での同期がスムーズに行えます

差分プレビューの活用

変更内容の確認方法

コミットする前に、どのファイルがどう変更されたかを確認できます。

コマンドパレット（Cmd + P または Ctrl + P）を開き、「Obsidian Git: Open diff view」と入力します。

すると、以下のような情報が表示されます。

diffCopy code# example-note.md の差分表示例

- 以前のバージョンの内容
+ 新しく追加・変更された内容

@@ -10,7 +10,7 @@
 ## セクションタイトル

-この部分が削除されました。
+この部分が追加されました。

上記のように、削除された行は -、追加された行は + で表示されるため、変更箇所が一目でわかりますね。

ファイルごとの差分確認

特定のファイルだけを確認したい場合は、以下の手順で行います。

1. 左サイドバーでファイルを右クリック
2. 「Git: View file diff」を選択
3. 差分ビューが表示される

これにより、意図しない変更が含まれていないかを確認してからコミットできます。

ノートの復旧手順

過去のコミットを探す

誤って削除したり、上書きしてしまったノートを復旧するには、まず過去のコミット履歴を確認します。

コマンドパレットから「Obsidian Git: Open git history」を実行すると、コミット履歴が時系列で表示されます。

yamlCopy codevault backup: 2025-11-15 14:30:00 - 3 files changed
vault backup: 2025-11-15 14:25:00 - 1 file changed
vault backup: 2025-11-15 14:20:00 - 2 files changed

復旧したい時点のコミットを特定しましょう。

特定のファイルを復元

特定のファイルだけを過去の状態に戻すには、以下のコマンドを使用します。

bashCopy code# ターミナルで実行
git checkout [コミットID] -- path/to/file.md

例えば、コミット ID が abc1234 で、notes​/​important.md を復元する場合は以下のようになります。

bashCopy codegit checkout abc1234 -- notes/important.md

これで、指定したファイルだけが過去の状態に戻ります。他のファイルには影響しません。

Vault 全体を過去の状態に戻す

Vault 全体を特定の時点に戻したい場合は、慎重に操作する必要があります。

まず、現在の状態をバックアップしてから実行しましょう。

bashCopy code# 現在の状態をタグとして保存
git tag backup-before-reset

その後、以下のコマンドで過去の状態に戻します。

bashCopy code# 特定のコミットまで戻る（変更内容は保持）
git reset --soft [コミットID]

# 特定のコミットまで戻る（変更内容を破棄）
git reset --hard [コミットID]

--soft オプションを使えば、変更内容は作業ディレクトリに残るため、必要な部分だけを選択的に復元できるんです。

トラブルシューティング

コンフリクトが発生した場合

複数デバイスで同時に編集すると、コンフリクト（衝突）が発生することがあります。

Obsidian Git プラグインは、コンフリクトを検知すると通知を表示します。この場合、以下の手順で解決してください。

1. コマンドパレットから「Obsidian Git: List changed files」を実行
2. コンフリクトが発生しているファイルを開く
3. 以下のようなマーカーが表示される

markdownCopy code<<<<<<< HEAD
現在のバージョンの内容
=======
リモートのバージョンの内容
>>>>>>> origin/main

必要な内容を残し、マーカーを削除して保存します。

その後、コミットとプッシュを実行すれば解決です。

プッシュに失敗する場合

GitHub へのプッシュが失敗する場合、認証情報に問題がある可能性があります。

最近の GitHub では、パスワード認証が廃止され、Personal Access Token（PAT）の使用が必須になっています。

以下の手順で PAT を作成してください。

1. GitHub の設定画面を開く
2. 「Developer settings」→「Personal access tokens」→「Tokens (classic)」
3. 「Generate new token」をクリック
4. 必要なスコープを選択（repo 全体にチェック）
5. トークンを生成してコピー

生成したトークンを、以下のように設定します。

bashCopy code# リモート URL をトークン付きに変更
git remote set-url origin https://[トークン]@github.com/username/obsidian-vault.git

これで、プッシュが正常に実行できるようになります。

プラグインが動作しない場合

プラグインが正しく動作しない場合は、以下の点を確認してください。

#	確認項目	対処方法
1	Git がインストールされているか	git --version で確認
2	リポジトリが初期化されているか	.git フォルダの有無を確認
3	プラグインが最新版か	アップデートを確認
4	他のプラグインとの競合	セーフモードで起動して確認

特に、他のプラグインとの競合は見落としがちなので、セーフモードでの動作確認が有効ですね。

まとめ

本記事では、Obsidian Git プラグインの導入から、自動コミット設定、差分プレビュー、復旧手順までを詳しく解説しました。このプラグインを活用することで、大切なノートを誤削除や上書きから守り、安心して知的活動を続けられるようになります。

Git の知識がない方でも、今回紹介した手順に従えば、簡単にバージョン管理を導入できるでしょう。最初は自動コミットの設定だけでも十分効果がありますので、まずは試してみることをおすすめいたします。

さらに、GitHub と連携すれば、複数デバイス間での同期やクラウドバックアップも実現できます。日々のノート作成がより安全で快適になることを願っています。

ぜひ、Obsidian Git プラグインを導入して、あなたの知的生産活動をさらに充実させてくださいね。

関連リンク

• Obsidian Git プラグイン公式ページ
• Obsidian 公式サイト
• Git 公式ドキュメント
• GitHub 公式サイト
• Personal Access Token の作成方法