12k
All articles

より良いノート管理のためのObsidianの5つのヒント

Obsidianのノート術5選: MOC、Dataview、Bases、Canvas、Mermaid、レビュー用ダッシュボード、Git同期で再利用しやすいMarkdown保管庫へ。

OpenReplay Team
OpenReplay Team
より良いノート管理のためのObsidianの5つのヒント

Obsidianで最も効果的な習慣とは、ノートをより多く記録することではなく、すでに持っているノートを見つけやすくつながりのある再利用可能なものにすることです。Dann Bergのシステム論から鋭い一言を借りるなら、自分がノート管理システムを構築しているのか、それとも実際の作業のためにシステムを使っているのかを常に意識することが重要です。多くのvaultが機能しなくなるのは、所有者がひたすら前者に時間を費やし、後者をほとんど行わないからです。記録すること自体は簡単ですが、再利用こそが難しい部分です。以下の5つの実践は、まさにその「再利用」を目的としており、Markdownを使い慣れた開発者向けに書かれています。そのため、基本的なヘッダーや箇条書きの説明は省略しています。

重要なポイント

  • Map of Content(MOC)とは、[[wikilinks]]で関連ノートをつなぐハブノートのことです。Dataviewクエリと組み合わせることで、リストを手動で管理する必要なく、ハブが自動的に整理されます。
  • インラインのテキストベースのクエリにはDataviewを使用し、コード不要でフィルタリング可能なテーブル、カード、リスト、マップビューが必要な場合はBases(2025年8月にリリースされたObsidianのネイティブコアデータベースプラグイン)を活用しましょう。
  • Canvasは組み込みのコアプラグインであり、ObsidianはMermaidダイアグラムをネイティブでレンダリングするため、追加のインストールなしにサービスアーキテクチャを図示できます。
  • ノート管理で難しいのは再利用です。過去7日間に変更されたノートを表示するDataviewダッシュボードを週次で確認することで、書くだけのvaultを定期的に見直すvaultへと変えることができます。
  • Obsidianのvaultは単なるMarkdownファイルのフォルダであるため、git initを実行するだけで、有料のObsidian Syncを使わずとも、無料のバージョン履歴、行レベルの差分管理、マシン間の同期が実現できます。

1. Map of Contentを構築し、BasesとDataviewの使い分けを理解する

Map of Content(MOC)とは、[[wikilinks]]で関連ノートをつなぎ、クエリを使って自動的に整理するハブノートです。payments-serviceに関するすべてのノートのテーブルを手動で管理する代わりに、作業しながらリンクを追加し、クエリでそれらを表示させます。最もシンプルな方法は、コミュニティクエリプラグインであるDataviewを使って、現在のMOCにリンクしているすべてのノートを一覧表示することです。

LIST FROM [[]]

FROM [[]]は「このノートにリンクしているノート」として解釈されるため、[[Payments MOC]]でタグ付けしたノートはすべて、メンテナンス不要で自動的に表示されます。Dataviewはノートを読み取るだけで書き込みは行いません。公式ドキュメントにも、メタデータを変更しないことが明記されているため、クエリによってvaultが破損する心配はありません。

既存のTips記事の多くが見落としている2026年の重要なアップデート: Obsidian Basesは、ノートをObsidian内で編集・フィルタリング可能なデータベースに変換する無料のコアプラグインです。2025年8月18日にコアプラグインとしてリリースされ、base内のすべてのデータはローカルのMarkdownファイルとYAMLに保存されたプロパティによって管理されます。Basesのドキュメントによると、ファイルとプロパティに対してデータベースライクなビュー(テーブル、カード、リスト、マップ)を提供するコアプラグインとして位置付けられています。これにより、どちらを使うかは明確な判断が必要になります。

Dataviewを選ぶ場合Basesを選ぶ場合
ノート内にプレーンテキストとしてクエリを埋め込みたい場合コード不要でGUIによるフィルタリングビューが欲しい場合
タスクの集計やインラインフィールドの計算が必要な場合テーブル、カード、リスト、マップのレイアウトが必要な場合
コード駆動で表現力の高いロジックが必要な場合安定性、ネイティブ対応、モバイルフレンドリーさを重視する場合

どちらも同じYAMLフロントマターを使用するため、クリーンなプロパティ(status:repo:updated:)への投資は、どちらを選んでも有効です。

2. 意図を持ってリンクし、ノートをアトミックに保つ

意図を持ってリンクしましょう。説明的なリンクはグラフをナビゲートしやすくしますが、曖昧なリンクはノイズになります。[[JWT refresh-token rotation]]はリンク先の内容を明確に示しますが、「詳細はこちら」のようなリンクは二度と見つけられないでしょう。その効果は複利的に積み重なります。すべてのwikiリンクは双方向であるため、[[OAuth token refresh flow]]のバックリンクペインは、インデックスを手動で管理することなく、そのノートに関連するインシデントレポート、スタンドアップノート、設計ドキュメントのライブインデックスとして機能します。

各ノートはアトミックに保ちましょう。つまり、1つのノートには1つのアイデアだけを記述します。[[repo: payments-service]]のリトライセマンティクスに関するアトミックなノートは、さまざまなコンテキストで再利用できますが、同じ内容が2,000文字の会議メモに埋もれていれば、事実上見えない存在になります。アトミックなノートは新しい思考の源泉でもあります。無関係な2つのノートをつなぐことで、どちらのソースにも含まれていなかったアイデアが生まれます。ノートは短く、単一の目的に絞り、構造はフォルダではなくリンクに担わせましょう。

3. CanvasとMermaidでシステムを図示する

Canvasはコミュニティプラグインではなく、組み込みのコアプラグインです。コアプラグインのリストでは、アイデアを無限のスペースに視覚的に配置してノートを整理する方法として説明されています。ライブノートを無限のサーフェスに配置してつなぎ合わせることで、サービスアーキテクチャ、インシデントのタイムライン、アルゴリズムの制御フローをスケッチでき、各カードはvault内の完全なノートにリンクされます。

ノートの内部に属するダイアグラムには、mermaidフェンスを埋め込みましょう。Obsidianはプラグインのインストールなしにネイティブでレンダリングします(現在のビルドにはMermaid 11.13.0がバンドルされています)。

```mermaid
graph TD
    A[Client request] --> B[API gateway]
    B --> C{Auth valid?}
    C -->|Yes| D[Service handler]
    C -->|No| E[401 -> refresh flow]
    D --> F[(Postgres)]
```

これにより、リーディングビューにリクエストライフサイクルのフローチャートがレンダリングされます。ノート本文にプレーンテキストとして記述されているため、ダイアグラムはGitで差分が明確に表示され(ヒント5を参照)、ノートと一緒に移動します。アーキテクチャが変更されても再生成が必要なバイナリ画像は不要です。

4. Obsidianのノート管理を定期的に見直す生きたナレッジベースにする

ノート管理の難しさは記録することではなく、再利用することにあります。ほとんどのノートは一度書かれたきり、二度と開かれません。vaultをアーカイブではなく、生きたナレッジベースとして扱いましょう。ノートは変更可能であり、見直すたびにリファクタリング、再リンク、整理を行うべきです。これを習慣化するための仕組みが、定期的なレビュークエリです。過去7日間に変更したすべてのノートを表示するDataviewブロックをダッシュボードノートに追加しましょう。

LIST
WHERE file.mtime >= date(today) - dur(7 days)
SORT file.mtime DESC

毎週金曜日にこれを開くことで、vaultは書くだけの場所でなくなります。未完了タスクを表示するクエリ(TASK WHERE !completed)を追加し、コアのRandom Noteコマンドをホットキーに割り当てて、偶発的な再発見を促しましょう。クエリよりも習慣が重要です。一度も開かれないノートは、書かなかったも同然です。

5. GitでvaultをバージョニングおよびSync管理する

Obsidianのvaultは単なるMarkdownファイルのフォルダであるため、その中でgit initを実行するだけで、有料のObsidian Syncを使わずとも、無料のバージョン履歴、行レベルの差分管理、マシン間の同期が実現できます。すでにツールを持っているので、それをvaultに向けるだけです。

cd my-vault
git init
printf '.obsidian/workspace.json\n.obsidian/workspace-mobile.json\n.trash/\n' > .gitignore
git add .
git commit -m "Initial vault snapshot"

.gitignoreにより、変更頻度の高いローカル状態(ウィンドウレイアウト、ゴミ箱)を履歴から除外しつつ、ノート、プラグイン設定、.baseファイルは保持されます。その後、git loggit diffでノートがどのように変化したかを正確に確認できます。これは独自仕様のノートアプリでは得られない種類の監査証跡です。プライベートリモートにプッシュし、他のマシンでgit pullすることで同期できます。

正直なところ注意点もあります。Gitはバージョニングと非同期の同期であり、リアルタイムのコラボレーションツールではありません。プルする前に2台のマシンで同じノートを編集すると、コードと同様にマージコンフリクトを手動で解決する必要があります。個人のvaultであれば、それは十分に許容できるトレードオフです。また、これが仕事用のvaultであっても、ライセンスの心配は不要です。Obsidianは2025年2月から商用利用が無料となり、以前必要だった商用ライセンス(ユーザーあたり年間50ドル)は任意のサポート手段となりました。


5つすべてを一度に試みるのではなく、今週はそのうちの1つを実践してみましょう。Gitの初期化は15分で完了し、レビューダッシュボードはクエリ1つで作れます。目標は、より複雑なシステムを構築することではなく、実際に開き直し、つなぎ合わせ、再利用できるノートが入ったvaultを作ることです。

よくある質問

BasesはObsidianのDataviewを置き換えるものですか?

いいえ。Basesは2025年8月18日にObsidianがリリースしたネイティブのコアプラグインで、コード不要でGUIによるフィルタリングが可能なデータベースビューを提供します。一方、Dataviewはノート内でテキストベースの表現力豊かなクエリ言語を提供するコミュニティプラグインとして引き続き存在します。どちらも同じYAMLフロントマターから読み取ります。Dataviewは現在も広く使われており、コミュニティではDataviewとBasesを組み合わせたり、Basesに移行したりするケースが増えていますが、Dataviewが廃止されたり放棄されたりしたわけではありません。

プラグイン設定を失わずにGitでObsidian vaultを同期できますか?

はい。vaultはプラグインの設定を.obsidianフォルダ内のプレーンファイルとして保存しており、GitはMarkdownノートと一緒にそれらを追跡します。.obsidian/workspace.json、.obsidian/workspace-mobile.json、.trash/など、変更頻度の高いローカル状態のみを.gitignoreに追加してください。これにより、コミュニティプラグイン、ホットキー、テーマ、.baseファイルをマシン間で保持しつつ、ウィンドウレイアウトのノイズを履歴から除外できます。Gitはバージョニングと非同期の同期を担いますが、リアルタイムのコラボレーションには対応していません。

クエリ実行時にDataviewがノートを変更または破損することはありますか?

いいえ。Dataviewはノートのコンテンツとメタデータを読み取って結果を表示・計算するだけです。公式ドキュメントには、ノートやメタデータを編集することはなく、常にそのままの状態を保つと明記されています。クエリはリーディングビューで出力をレンダリングするだけで、ソースファイルへの書き戻しは行わないため、クエリに誤りがあっても表示エラーが発生するだけで、vaultのデータが変更・破損することはありません。

仕事でObsidianを使用するためにライセンスの購入は必要ですか?

いいえ。2025年2月20日以降、Obsidianは規模を問わずあらゆる組織で商用利用が無料となりました。以前必要だった商用ライセンス(ユーザーあたり年間50ドル)は任意となり、Obsidianをサポートする手段としてのみ存在します。つまり、仕事用vaultをGitで管理したり、会社のマシンでObsidianを使用したりする際に、必須のライセンスコストは発生しません。

CanvasはObsidianのコアプラグインですか、それともコミュニティプラグインですか?

Canvasはコミュニティプラグインではなく、組み込みのコアプラグインです。Obsidianのコアプラグインリストでは、アイデアを無限のスペースに視覚的に配置してノートを整理する方法として説明されています。コミュニティカタログから何かをダウンロードすることなく、設定から有効化できます。Canvasを使うと、vaultのライブノートを無限のサーフェスに配置してリンクできるため、カードは完全なソースノートとつながったままになります。

Understand every bug

Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — self-hosted, with full data ownership.

Star on GitHub

We use cookies to improve your experience. By using our site, you accept cookies.