ObsidianをGitHubで同期!Gitプラグインの設定とバックアップ方法

  • URLをコピーしました!

Obsidianのデータを複数のPCで同期させたいけれど、月額料金がかかる公式Syncの導入を迷っている方は多いのではないでしょうか。無料で、かつデータの安全性を極限まで高めたいなら、プログラミングの世界で使われる「Git(ギット)」を活用した同期が最強の選択肢です。

Gitを使えば、データの同期だけでなく「1週間前の状態に戻す」といった高度な履歴管理も自分で行えるようになります。設定には少しコツが必要ですが、一度仕組みを作ってしまえば、大切なノートを一生守り抜く盤石な環境が手に入ります。この記事では、初心者の方でも迷わずにGitHub連携を完結させる手順を詳しく解説します。

目次

Obsidian Gitを使うと何が変わる?同期とバックアップの仕組み

Obsidian Gitは、世界中のエンジニアが信頼を寄せる「Git」という技術をObsidianに組み込む手法です。単にファイルをクラウドに放り込むだけの同期とは異なり、いつ、誰が、どの行を書き換えたかという情報をすべて記録してくれます。

この仕組みを導入することで、万が一のデータ消失を恐れる必要がなくなるだけでなく、複数のPCを跨いだ共同作業のようなスムーズな同期が実現します。まずは、この手法がなぜ多くのこだわり派ユーザーに選ばれているのか、その仕組みの凄さを見ていきましょう。

ファイルの変更履歴がすべて「証拠」として残る

一般的なクラウド同期は「最新の状態」しか保存しません。しかしGitを使えば、ノートを保存した瞬間の状態が「コミット」という単位で積み重なっていきます。

例えば、昨日書いた文章を今日になって誤って消してしまい、さらに上書き保存してしまったとしましょう。通常の同期なら泣き寝入りするしかありませんが、Gitなら昨日の時点のデータをピンポイントで呼び戻せます。

  • 書き換えの経緯を1つずつ記録
  • 過去の状態を自由に閲覧
  • 間違えて消してもすぐに復旧

こうした「やり直しが効く」という安心感は、膨大な知識を蓄積するノートアプリにおいて、何物にも代えがたい価値になります。思考を止めることなく、大胆にノートを編集できるようになるでしょう。

GitHubを使えば無料で容量制限なく同期できる

Gitのデータを保存する場所(リモートリポジトリ)として「GitHub」を利用すれば、これらすべての機能を無料で使い放題になります。GitHubは世界最大のコード共有プラットフォームであり、個人のノートを保存する程度であれば、容量や転送量を心配する必要はほぼありません。

iCloudやDropboxのような無料枠の制限を気にしなくて済むため、画像やPDFをたくさん貼り付けるスタイルの人にも最適です。自分専用の非公開(プライベート)リポジトリを作れば、中身を他人に見られる心配もありません。

フォルダ分けよりも強力な「過去への復元」機能

フォルダ同期の場合、同期ミスでファイルが壊れたり、古いデータに先祖返りしたりすることが稀にあります。Gitはこうした「同期の不整合」に非常に強い仕組みを持っています。

変更内容を1つひとつのパーツとして管理するため、どの変更が正しくて、どの変更が競合しているのかを論理的に判断できるからです。

以下の表に、一般的なクラウド同期とGit同期の違いを整理しました。

特徴一般的なクラウド同期Obsidian Git
コスト無料枠あり/課金あり完全に無料
履歴の深さ過去30日程度が多い永久にすべて記録
信頼性同期ミスが起きることがある構造的に壊れにくい
設定難易度かなり簡単最初だけ少し難しい

確かに最初は「難しそう」と感じるかもしれませんが、この信頼性の高さこそが、長く使い続けるための最大の判断材料になります。

事前準備:GitのインストールとGitHubアカウント作成

Obsidianの中でプラグインを動かす前に、PC側の土台作りが必要です。GitはWindowsやMacといったOSの上で動くソフトなので、まずはこれをあなたのPCに覚えさせる作業から始めます。

設定のステップは大きく分けて3つです。どれも一度やってしまえば二度と触る必要のない作業なので、画面の指示に従って一つずつ進めていきましょう。

自分のPCにGitが入っているか確認して導入する

まずは、あなたのPCに「Git」というソフトが入っているか調べます。Windowsならコマンドプロンプト、Macならターミナルを開き、git --version と打ち込んでみてください。

もしエラーが出るようなら、公式サイトからインストーラーをダウンロードしてインストールしましょう。設定項目がたくさん出てきますが、基本的には「Next」や「デフォルトのまま」で進めて問題ありません。

  • Windows:Git for Windowsを導入
  • Mac:XcodeのツールやHomebrewで導入
  • インストール後の再起動を忘れずに

GitHubで自分だけの「秘密の保管庫」を作る方法

Gitが入ったら、次はインターネット上の保存先となる「GitHub」のアカウントを作ります。アカウントができたら、「New Repository」というボタンから新しい保管庫を作成しましょう。

ここで最も重要なのは、公開設定を必ず「Private(非公開)」にすることです。ここを間違えると、あなたの書いた日記やパスワードメモが世界中に公開されてしまいます。リポジトリの名前は「MyObsidian」など、自分がわかりやすいもので構いません。

認証をスムーズにするためのアクセストークンを取得しよう

最近のGitHubはセキュリティが厳しく、パスワードだけでログインすることができません。代わりに「Personal Access Token(PAT)」という、長い文字列の鍵を発行する必要があります。

GitHubの設定(Settings)から開発者向け設定を開き、有効期限を決めてトークンを発行しましょう。この文字列は一度しか表示されないので、メモ帳などにコピーしておいてください。後でObsidianから接続する際に、パスワードの代わりとして使います。

プラグインを設定してGitHubと連携する手順

土台ができたら、いよいよObsidian側の設定に入ります。ここでの目的は、PC内のObsidianフォルダをGitHubの保管庫と「同期していいよ」と許可することです。

エンジニアの方はコマンドでサクッと終わらせる作業ですが、Obsidian Gitプラグインを使えば、マウス操作を中心に設定を完了させることができます。

コミュニティプラグインから「Obsidian Git」を導入する

Obsidianの設定画面から「コミュニティプラグイン」を開き、有効化したあとに「Obsidian Git」を検索してインストールします。

このプラグインが、あなたの代わりにGitの難しい命令を裏側で実行してくれるようになります。インストールが終わったら「有効化」を押し、設定画面(歯車アイコン)を開いておきましょう。

作成したGitHubリポジトリをObsidianに紐付ける

インストールしただけでは、どこにファイルを送ればいいかObsidianは知りません。最初に一度だけ、PCのコマンド操作(またはプラグインの初期設定機能)を使って、先ほど作ったGitHubのアドレスを登録します。

基本的には、保管庫があるフォルダでGitの初期化を行い、GitHubのURLを「リモート」として追加する作業です。ここで、先ほど取得したアクセストークンを入力して、鍵をガチャリと回すイメージで接続を完了させます。

同期したくないファイルを外す「.gitignore」の重要性

Obsidianのフォルダ内には、同期する必要がないファイルもいくつか存在します。例えば、ワークスペースのレイアウト情報や一時的なキャッシュなどです。

これらを同期対象から外すために、.gitignore という名前のテキストファイルを作ります。この中に「同期しないでほしいファイル名」を書いておくことで、無駄な通信を減らし、同期エラーを防ぐことができます。

  • .obsidian/workspace.json(開いているタブの情報)
  • .obsidian/plugins/obsidian-git/data.json(Gitの設定)
  • node_modules(もしあれば)

これを設定しておかないと、PCとスマホで開いているタブが違うだけで同期がぶつかってしまうため、忘れずに設定しておきましょう。

毎日使う基本操作と自動バックアップ

設定が終われば、あとは普通にノートを書くだけです。Obsidian Gitの真骨頂は、あなたが何もしなくても裏側で勝手にバックアップを取ってくれる「全自動」の設定にあります。

「バックアップし忘れた!」というミスを物理的に防ぐために、自動化の設定を煮詰めていきましょう。ここでは、おすすめの自動設定値と、手動で同期したい時の操作について解説します。

数分おきに勝手に保存!自動Push機能の使い道

プラグインの設定にある「Vault backup interval」という項目に数字を入れましょう。例えば「5」と入れると、5分おきに変更があったファイルを自動で記録(Commit)し、GitHubへ送信(Push)してくれます。

常に最新の状態がクラウドに送られるため、PCが突然壊れても最大5分前の状態までは確実に守られます。

  • 変更がある時だけ動く
  • バッテリー消費は微々たるもの
  • 意識せずに済むのが最大のメリット

アプリを閉じる時に同期を完了させる設定のコツ

「PCを閉じて、すぐにスマホで続きを書きたい」という場面は多いですよね。そのために、「Pull updates on startup(起動時に同期)」と「Push on backup(バックアップ時に送信)」をオンにしておきましょう。

これにより、アプリを開いた瞬間に最新データが降ってきて、ノートを書き終えてしばらくすると自動で送られるようになります。作業の「入り口」と「出口」を固めることで、データの不整合を防ぐことができます。

手動でバックアップしたい時のコマンド操作

自動設定を待たずに、今すぐ同期したい時もあります。そんな時はコマンドパレット(Ctrl/Cmd + P)を開き、「Obsidian Git: Commit all changes」と「Push」を実行しましょう。

これを実行すれば、その瞬間のデータがGitHubに刻まれます。大きなプロジェクトが一段落した時や、外出前に確実に同期させたい時に便利な操作です。

スマホでも同期したい!iOSとAndroidの方法

「GitはPC専用だ」と思われがちですが、工夫次第でスマートフォンでも同期環境を作れます。ただし、モバイルアプリの制限により、PC版ほど「入れるだけ」とはいかないのが現状です。

ここでは、iPhoneやAndroidユーザーが直面する壁と、それを乗り換えるための現実的な手段をご紹介します。

iPhone・iPadでは外部アプリ「Working Copy」を併用する

iOS(iPhone/iPad)には、Gitを強力にサポートする「Working Copy」という神アプリが存在します。これを使えば、GitHubのデータをiOS内のObsidianが触れる場所にダウンロードできます。

Working CopyでGitHubと同期し、そのフォルダをObsidianで開くという「二段構え」になります。少し複雑に見えますが、一度繋がってしまえば、Working Copy側で同期ボタンを押すだけで最新の状態を保てます。

AndroidでGit同期を実現するための代表的な手順

Androidの場合は、もう少し自由度が高いものの、設定はややテクニカルです。多くのユーザーは「Termux」というアプリを使い、Linuxのような環境をスマホ内に作ってGitを動かしています。

あるいは、PC版と同じ「Obsidian Git」プラグインが一部のAndroid環境でも動作するようになっていますが、OSの制限により書き込み権限でつまづくこともあります。Androidユーザーは、まずプラグインが直接動くか試し、ダメならTermux等の外部ツールを検討するのが近道です。

モバイル版での「重さ」や「通信量」の注意点

スマホでのGit同期は、PCに比べて電池の減りが少し早くなったり、大量の画像を同期する際に通信量を食ったりすることがあります。

特にiOSのWorking Copyなどは、バックグラウンドでの同期に制限があるため、ノートを書く前に「同期ボタン」を押す癖をつける必要があります。

「全自動」とはいかない場面もあることを理解した上で、運用を工夫しましょう。

デバイス同期の手順安定感
PC (Mac/Win)プラグインで完結非常に高い
iOSWorking Copyを利用高い(手動操作あり)
Androidプラグイン or Termux環境による

過去の履歴を復元する手順

Gitを導入して最も「やっててよかった」と思うのは、トラブルが起きた時です。誤操作でファイルを真っ白にしてしまっても、落ち着いて操作すれば元の状態に戻せます。

特別なソフトを使わなくても、GitHubのウェブサイトやObsidian内のコマンドから復元は可能です。いざという時のための「消火訓練」として、以下の手順を頭の片隅に置いておきましょう。

削除したファイルの取り戻し

ノートを削除してしまい、ゴミ箱からも消えてしまった。そんな時はGitHubのリポジトリページを開き、「Commits」の履歴を遡りましょう。

削除される直前のコミットを見つけ、その時のファイルの中身をコピーして新しいノートに貼り付けるだけです。Gitは一度でも記録した情報を勝手に消すことはありません。あなたが「消した」という事実すらも、一つの記録として残っているからです。

特定の日の状態確認

「3日前の自分の思考に戻りたい」と思った時も、Gitなら簡単です。履歴から3日前のコミットを選べば、その瞬間のノートの状態を閲覧できます。

過去の自分と対話するように、当時のメモを確認して今のノートに反映させる。そんな使い方ができるのは、すべての足跡を記録しているGit連携ならではの醍醐味です。

コミットメッセージの活用

余裕があれば、手動で保存する際に「〇〇プロジェクト完了」といった短いメモ(コミットメッセージ)を残してみましょう。

後で履歴を見返した時に、何のために変更したのかが一目でわかるようになります。日記を付けている人なら、その日の気分をメッセージに残すのも、後から振り返った時に面白い記録になります。

トラブル解決!競合や認証エラー

Gitは非常に賢い仕組みですが、使い慣れないうちはエラーメッセージに戸惑うこともあるでしょう。特に「同期がぶつかった時」と「鍵が合わない時」の2パターンが大半です。

パニックにならずに対応すれば、データが消えることはありません。よくあるトラブルの原因と、その解決策をシンプルに整理しました。

コンフリクト解消のステップ

PCとスマホで同じ行を書き換えて同期すると、「どちらを優先すべきか分からない」という競合(コンフリクト)が発生します。

この時、ファイル内には <<<<<<< HEAD といった変な記号が書き込まれます。

  1. 記号で囲まれた部分を確認する
  2. 残したい方の文章を選び、記号を削除して整形する
  3. 再度バックアップを実行するこれだけで解決です。Gitが「勝手に判断して消さない」からこそ起きる親切なエラーだと考えましょう。

認証失敗の確認

「Pushに失敗しました」というエラーが出る場合、多くはアクセストークンの期限切れか、入力ミスです。

GitHubで新しいトークンを発行し、Obsidianの設定画面でパスワード欄を上書きしてみましょう。また、インターネットに繋がっていない場所で自動Pushが走ってもエラーが出ますが、これは電波の良い場所に移動すれば解決します。

同期が止まった時の対応

もし何をやっても同期が動かなくなったら、一旦Obsidianを閉じ、PCのGitソフト(GitHub Desktopなど)で状況を確認するのが一番確実です。

Gitの状態を「クリーン」に戻す作業をすれば、また元通りに同期が始まります。

以下に、よくあるエラーの対処法をまとめました。

現象主な原因解決策
Pushできないネット未接続 / 認証切れネット確認 / トークン再発行
ファイルに謎の記号データの競合(コンフリクト)手動で文章を整えて保存
同期がずっと終わらないファイルが大きすぎる画像などを別の場所に逃がす

公式Syncや他のクラウドとの比較

ここまでGitの良さを伝えてきましたが、全員にGitが最適というわけではありません。世の中にはiCloudや公式Syncといった、もっと手軽な選択肢もあります。

最後に、あなたのライフスタイルに本当に合っているのはどの方法なのか、比較検討して答えを出しましょう。

公式Syncとの違い

Obsidian公式のSyncサービスは、月額料金がかかる代わりに「何もしなくても完璧に動く」のが魅力です。設定に1時間かけるのが苦痛な人や、スマホでの安定感を最優先したい人は、公式Syncに軍配が上がります。

対してGitは、「自分でコントロールしたい」という人向けです。履歴を細かく管理し、1円も払わずに無限の容量を使いたいという情熱があるなら、Git一択です。

Gitがおすすめな人

もしあなたが以下の項目に当てはまるなら、Git連携に挑戦する価値が十分にあります。

  • 過去の自分の思考を詳細に保存しておきたい
  • 複数のPC(WinとMacなど)を使い分けている
  • エンジニア的なツールを触るのが嫌いではない
  • 完全に無料で最強の環境を構築したい

逆に、ITの専門用語を見るだけで頭が痛くなるという人は、無理をせずiCloud等を使うのが幸せへの近道です。

クラウド併用のリスク

一番やってはいけないのが、「iCloudフォルダの中にGitリポジトリを作る」といった併用です。2つの同期システムが同じファイルを奪い合ってしまい、データが壊れる原因になります。

同期の手法は、必ず1つに絞りましょう。Gitを選ぶなら、同期されていないローカルなフォルダにObsidianの保管庫を作成し、そこからGitHubへ飛ばすのが最も安全な運用方法です。

まとめ:安全で自由なノート環境を手に入れよう

Obsidian Gitを使った同期とバックアップは、最初は設定の壁があるものの、一度乗り越えればこれ以上ないほどの安心感をもたらしてくれます。大切な知識をGitHubという巨大な金庫に預け、いつでも過去に戻れる権利を手に入れることは、長く知的な活動を続ける上での大きな支えになります。

  • 履歴管理: 過去の自分にいつでも会える安心感。
  • 無料・無制限: 容量やコストを気にせず、どこまでも書き続けられる。
  • 高い信頼性: 同期ミスに怯える日々からの解放。

まずはGitをインストールし、小さなテスト用リポジトリを作ってみることから始めてください。自分の手で同期をコントロールできる楽しさを知れば、あなたのObsidianライフはより自由で、よりクリエイティブなものに進化していくはずです。

よかったらシェアしてね!
  • URLをコピーしました!

この記事を書いた人

目次