Obsidianプラグインが表示されない・動かない

おすすめ記事のとおりにプラグインを入れようとしたら、「閲覧」ボタンが押せない。入れたはずなのにコマンドに出てこない。プラグインの不調は、設定のスイッチ1つで説明がつくことが多い。

結論 インストールできないなら制限モード、入れたのに動かないなら「有効化」のスイッチを見る。スマホだけ消えたなら同期の設定とデスクトップ専用かどうか、更新後に急に壊れたなら制限モードでの切り分けが先。

目次 / INDEX

症状から当たりをつける

まず、自分の症状がどれに近いかを表で探す。

症状	最初に見る場所
「閲覧」が押せない・インストールできない	制限モード、ネットワーク、本体の版
入れたのにコマンドに出ない	「インストールされたプラグイン」のスイッチ
スマホや別のパソコンで消えた	最初に開いたときの確認画面、同期の設定
スマホでだけ動かない	デスクトップ専用のプラグインか
更新したら急に動かない	制限モードで比べる、本体とプラグインの版

「閲覧」が押せない・インストールできない

制限モードがオンになっている

Obsidianは、初期状態で制限モードになっている。サードパーティのコードを勝手に動かさないための仕組みで、この間はコミュニティプラグインを探すことも入れることもできない。

1. 左下の歯車から設定を開く
2. 左の一覧で「コミュニティプラグイン」を選ぶ
3. 制限モードを解除するボタンを押す（日本語表示では「コミュニティプラグインを許可」、公式ヘルプの英語表記ではTurn on community plugins）
4. 「閲覧」から名前で検索し、「インストール」を押す

解除するとき、プラグインが端末上で任意のコードを動かせることと、有効にする前のバックアップを勧める注意書きが表示される。読んだうえで進めればいい。

学校や会社のネットワークで止まっている

プラグインの本体は、Obsidianのサーバーではなく作者のGitHubのリリースからダウンロードされる。開発者向けドキュメントに、インストール時に main.js などをGitHubから取ってくると書かれている。

GitHubへの接続が制限されたネットワークでは、一覧は見えてもインストールが失敗しうる。家の回線やスマホのテザリングに切り替えて、同じ操作を試すと切り分けられる。

Obsidian本体が古い

プラグインには、動くために必要なObsidianの最低バージョンが決められている。開発者向けドキュメントでは manifest.json の minAppVersion がその項目だ。

本体は、設定の一番上のページにある「更新を確認」で最新にできる。デスクトップ版には、自動更新では上がらない「インストーラーのバージョン」もある。公式ヘルプは、プラグインが先にインストーラーの更新を求めることがあると書いている。

インストーラーは、公式サイトのダウンロードページから入れ直せば新しくなる。公式ヘルプによると、アンインストールは要らない。

インストールしたのに動かない

有効化のスイッチが切れている

インストールと有効化は別の操作だ。インストール直後の画面で「有効化」を押し忘れると、プラグインは入っているのに何も起きない。

設定の「コミュニティプラグイン」を開き、「インストールされたプラグイン」の一覧を見る。そのプラグインの右端のスイッチがオフなら、オンにする。

設定を変えたのに反映されない

プラグインは、設定を読み直す仕組みを持たないものが多い。公式ヘルプも、同期で届いたプラグインの設定は基本的に再起動しないと効かないと書いている。

「インストールされたプラグイン」の欄にある更新のアイコンで、全プラグインを読み込み直せる。それでも変わらなければ、アプリを再起動する。スマホは強制終了してから開き直す。

ほかのプラグインとぶつかっている

2つのプラグインが同じキーや同じ操作を奪い合うと、どちらかが効かなくなる。制限モードを一時的にオンにして比べると、プラグインのせいかどうかがすぐ分かる。

制限モードをオンにしても、入れたプラグインは保管庫に残ったまま無視されるだけだ。公式ヘルプにそう書かれていて、オフに戻せば元の状態に戻る。

プラグインのせいと分かったら、半分ずつオフにして犯人を探す。10個入っていても、4回ほど比べれば1つに絞れる。

日本語入力とぶつかる例もある。リスト操作のOutlinerは、EnterキーとTabキーの動きを変える設定が初期状態でオンになっている。変換を確定するEnterとぶつかる問題は2021年に報告されて修正済みなので、古い版なら先に更新する。

更新しても起きるなら、そのキーの機能をオフにして比べる。

スマホや別の端末でプラグインが消えた

最初に開いたとき「制限モードで閲覧」を選んだ

プラグインの入った保管庫を、その端末で初めて開くと「この保管庫の作成者を信頼しますか？」と聞かれる。ここで「保管庫を制限モードで閲覧」を選ぶと、プラグインは入っているのに動かない。

同期で運ばれてきた自分の保管庫でも、その端末で初めて開くならこの確認の対象になる。設定の「コミュニティプラグイン」で制限モードを解除すれば、プラグインが動き出す。

同期の設定でプラグインが運ばれていない

同期の方法によっては、プラグインがそもそもほかの端末へ運ばれない。

• Obsidian Sync：初期設定では対象外。設定のSyncで「アクティブなコミュニティプラグインのリスト」と「インストールされているコミュニティプラグイン」をオンにする
• Remotely Save：.obsidian のような . で始まるフォルダは、初期設定では同期しない
• 端末ごとの設定フォルダ：「設定フォルダの優先を切り替える」で別の名前にすると、元の設定は新しいフォルダへ移らない

Obsidian Syncは、両方の端末でオンにしてから、受け取る側を再起動する。同期の方法別の症状はObsidianが同期されない時の直し方に分けて書いた。

スマホでは動かない作りになっている

プラグインの中には、パソコン版だけで動く前提のものがある。開発者向けドキュメントでは、Node.jsやElectronの機能を使うプラグインは isDesktopOnly で宣言する決まりだ。

この場合、同期の設定を直してもスマホでは使えない。プラグインの説明にモバイル対応の記載があるかを、入れる前に確かめる。スマホ側はObsidianをスマホで使うにあるように、プラグインを絞ったほうが軽く動く。

⚠️ iPhoneとiPadには、.obsidian フォルダを直接見る標準の方法がない。公式ヘルプは、中身を見るならTaioなどの別のアプリが要ると案内している。

更新したら急に動かない

プラグインが古いまま

コミュニティプラグインは、安全のため自動では更新されない。本体を新しくしたのに、プラグインだけ古いままという状態が起きやすい。

設定の「コミュニティプラグイン」で「アップデートを確認」を押し、更新があれば「すべてをアップデート」を押す。1つだけ更新したいなら、一覧のそのプラグインの横から更新できる。

本体の更新でプラグインが壊れた

本体を上げた直後から動かないなら、プラグイン側の対応待ちのことがある。まず制限モードで比べて、プラグインのせいかを確かめる。

プラグインのせいなら、そのプラグインのGitHubのIssuesを見る。同じ報告が既にあれば、作者の対応を待つか、一時的にスイッチを切っておく。

入れる前に知っておきたい安全のこと

公式ヘルプは、コミュニティプラグインについてObsidianと同じ権限で動くと説明している。ファイルへのアクセス、インターネットへの接続、別のプログラムのインストールもできる。

公式の一覧に載ったプラグインは、版ごとに自動で検査される。結果はコミュニティのディレクトリの各プラグインのページに、安全性の評価として出る。

入れるなら、利用者が多く、最近も更新されている定番から選ぶ。候補はObsidianのおすすめプラグインに、最初の5つまで絞って並べている。

それでも直らないとき

作者に報告するなら、エラーの中身を添えると話が早い。パソコンでは、Ctrl+Shift+I（Macは Command+Option+I）で開発者コンソールが開く。

1. 上部のメニューで「Console」を選ぶ
2. 横のメニューで「errors」を選ぶ
3. 赤いエラーを1つ選び、「Save as…」でログを保存する

コマンドパレットで「デバッグ情報を表示」を実行し、「クリップボードにコピー」を押すと、使っている版の情報も付けられる。スマホではコンソールが使いにくいので、公式ヘルプはLogstravaganzaというプラグインでログをノートに書き出す方法を勧めている。

同期や動作の重さなど、ほかの症状も一緒に出ているならObsidianのトラブル解決まとめから探せる。

参照した公式ページ（2026年9月確認）

• Obsidian公式ヘルプ「コミュニティプラグイン」（閲覧・インストール・有効化・更新・再読み込み）
• Obsidian公式ヘルプ「プラグインのセキュリティ」（制限モード、プラグインができること、審査）
• Obsidian公式ヘルプ「Obsidianのアップデート」（更新の確認、インストーラーの更新）
• Obsidian公式ヘルプ「Sync設定と選択的同期」（プラグインの同期の初期設定、再起動が要る設定）
• Obsidian公式ヘルプ「設定フォルダ」（設定フォルダの切り替え、iOSで見えない）
• Obsidian公式ヘルプ「ヘルプとサポート」（デバッグ情報、コンソールログ、モバイルのログ）
• Obsidian開発者向けドキュメント「Manifest」（isDesktopOnly・minAppVersion）
• Obsidian開発者向けドキュメント「Submit your plugin」（GitHubのリリースからのダウンロード）
• Obsidianの画面表示の日本語訳（obsidian-translations）（ボタン名・確認画面の日本語表記）
• Remotely Save README（隠しフォルダの扱い）
• Obsidian Outliner READMEとIssue #154（Enter・Tabの設定と日本語入力の衝突）

症状から探す Obsidianのトラブル解決まとめ 同期・プラグイン・重さ・リンク切れ・日本語入力まで、症状ごとに最初に確かめる場所をまとめた入口の記事。 読む →