[Obsidian]Macでプラグイン開発

「自分だけの機能をObsidianに追加したい」と思った時、一番高いハードルは環境構築です。今回は、余計なツールを一切排除し、Node.jsのインストールから、自作コマンドをObsidianのパレットに表示させるまでをステップバイステップで解説します。

STEP 1：Node.jsをインストールする

プラグインを動かすための「エンジン」であるNode.jsをMacに導入します。

ゼロから書く必要はありません。公式が用意しているテンプレートをダウンロードします。

フォルダの作成と移動: 開発用のディレクトリを作ります。
mkdir -p ~/Developer/obsidian-plugins cd ~/Developer/obsidian-plugins
テンプレートをダウンロード
git clone https://github.com/obsidianmd/obsidian-sample-plugin.git my-plugin cd my-plugin
依存ライブラリの解凍:
npm install

コードを書き換えたら即座に反映される「監視モード」でビルドを開始します。

npm run dev

注: このコマンドはターミナルを閉じずにそのままにしておいてください。

ここが一番のポイントです。作成中のフォルダをObsidianが読み込める場所にリンクさせます。

Obsidianのプラグインフォルダを探す:
- Obsidianを開き、「設定」 > 「コミュニティプラグイン」 > 「インストール済みプラグイン」の横にあるフォルダアイコンをクリックします。
- Finderが開くので、そのパスを確認します。
シンボリックリンクを貼る（Macの魔法）:ターミナルで以下を実行します（パスはご自身の環境に合わせてください）。
ln -s ~/Developer/obsidian-plugins/my-plugin /Users/あなたのユーザ名/Documents/YourVault/.obsidian/plugins/my-plugin
これで、コードを編集するたびにObsidian内のプラグインも自動で更新されます。

いよいよ動作確認です。

プラグインの有効化:Obsidianの「設定」 > 「コミュニティプラグイン」を開き、一度「再読み込み」を押してから、「Sample Plugin」をONにします。
コマンドパレットを叩く:Command + P を押し、「Sample Plugin: Open Sample Modal」と入力してみてください。