T-CREATOR

Obsidian Properties 速見表:型・表示名・テンプレ連携の実例カタログ

Obsidian Properties 速見表:型・表示名・テンプレ連携の実例カタログ

Obsidian でノートを管理していると、タグや日付、ステータスなどのメタデータを効率よく扱いたい場面が増えてきますよね。Properties(プロパティ)機能を使えば、YAML フロントマターをより直感的に操作でき、検索やフィルタリングもスムーズになります。本記事では、プロパティの型・表示名のカスタマイズ・テンプレート連携の実例を速見表形式で整理し、初心者の方でもすぐに活用できる形でお届けします。

Properties 速見表

以下の表は、Obsidian で利用できる主要なプロパティ型と、その特徴・用途を一覧にまとめたものです。

#プロパティ型説明主な用途表示例
1Text単一行のテキストタイトル、カテゴリ名author: John Doe
2Multitext複数行のテキスト長い説明文、要約summary: これは...
3Number数値スコア、ページ数、優先度priority: 5
4Checkboxチェックボックス(true/false)完了フラグ、公開状態published: true
5Date日付のみ作成日、期限日due: 2025-11-21
6DateTime日付+時刻イベント開始時刻start: 2025-11-21T10:00
7List複数値(タグ風)タグ、カテゴリ配列tags: [obsidian, tips]
8Link内部リンク関連ノートへのリンクrelated: [[Note]]

この表を参考にすれば、どの型をどの場面で使うべきか迷わず選択できますね。

表示名カスタマイズ速見表

プロパティのキー名(内部名)と表示名(UI 上の名前)を分けることで、日本語表示も可能になります。

#内部キー名表示名設定方法備考
1author著者Settings → Types → 表示名設定UI で日本語表示
2due_date期限日同上スネークケースも可
3is_published公開済み同上Checkbox 型推奨
4related_notes関連ノート同上List or Link 型

表示名を設定することで、チーム共有時にも分かりやすいノート管理が実現できます。

テンプレ連携速見表

Templater プラグインや Core Templates 機能と組み合わせることで、プロパティを自動挿入できます。

#テンプレ種類記述例説明
1Core Templatescreated: {{date}}作成日を自動挿入
2Templatercreated: <% tp.date.now("YYYY-MM-DD") %>柔軟な日付フォーマット
3Templaterauthor: <% tp.user.name %>ユーザー名を自動取得
4Templatertags: <% tp.file.folder() %>フォルダ名をタグに設定
5動的 Checkboxpublished: false初期値を false に固定

テンプレートを使えば、毎回手動で入力する手間が省け、ミスも減りますね。

背景

Obsidian は Markdown ベースのナレッジ管理ツールとして人気がありますが、バージョン 1.4.0 以降、YAML フロントマターを視覚的に編集できる Properties 機能が導入されました。

以下の図は、従来の YAML フロントマターと新しい Properties UI の違いを示しています。

mermaidflowchart TB
  old["従来の YAML<br/>フロントマター"] -->|手動編集| yaml["---<br/>key: value<br/>---"]
  new["Properties 機能"] -->|GUI 編集| ui["プロパティパネル<br/>(型付き入力)"]
  yaml -->|課題| issues["・入力ミス<br/>・型の不統一<br/>・視認性低"]
  ui -->|解決| benefits["・型安全<br/>・補完機能<br/>・一覧表示"]

従来は YAML フロントマターを手書きで編集していたため、入力ミスや型の不統一が発生しやすい問題がありました。Properties 機能を使うことで、GUI から型付きで入力でき、補完機能やバリデーションも効くため、メタデータ管理の品質が大きく向上します。

この機能により、Obsidian は単なるメモアプリから、データベース的な使い方もできる強力なツールへと進化したと言えるでしょう。

特に、チームでのナレッジ共有やプロジェクト管理、論文管理など、メタデータを活用したい場面で威力を発揮します。

課題

Properties 機能は便利ですが、初めて使う方には以下のような課題がありました。

まず、どの型をどの場面で使うべきか分かりにくい点です。Text と Multitext の違い、Date と DateTime の使い分けなど、型の種類が多く選択に迷います。

次に、表示名のカスタマイズ方法が不明瞭です。内部キー名は英語で管理したいが、UI では日本語で表示したい、といったニーズに対応する設定場所が分かりにくいです。

さらに、テンプレートとの連携方法が体系的に整理されていないことも課題です。Core Templates と Templater プラグインのどちらを使うべきか、どう書けば自動入力できるのか、公式ドキュメントだけでは実例が不足しています。

以下の図は、これらの課題が発生する流れを示しています。

mermaidflowchart LR
  user["ユーザー"] -->|Properties を使いたい| q1["どの型を選ぶ?"]
  q1 -->|迷う| issue1["型選択の課題"]
  user -->|日本語表示したい| q2["表示名の設定は?"]
  q2 -->|設定場所不明| issue2["カスタマイズの課題"]
  user -->|自動化したい| q3["テンプレ連携は?"]
  q3 -->|実例不足| issue3["連携の課題"]

これらの課題があると、せっかくの便利機能も使いこなせず、結局 YAML を手書きする従来の方法に戻ってしまうことになりかねません。

そこで本記事では、型・表示名・テンプレ連携の実例を体系的にまとめ、すぐに使えるカタログとして提供します。

解決策

上記の課題を解決するため、以下の 3 つのアプローチで Properties 機能を体系的に整理しました。

型の選択基準を明確化

各プロパティ型の特徴と、推奨される用途を一覧表で整理しました。これにより、データの性質に応じて最適な型を迷わず選択できます。

表示名カスタマイズの手順を具体化

Settings から Type 設定にアクセスし、表示名を設定する手順を実例付きで解説します。内部キー名と表示名を分離することで、コードとしての可読性と UI の分かりやすさを両立できますね。

テンプレート連携のパターンをカタログ化

Core Templates と Templater それぞれの記述例を、よく使うパターン別に整理しました。作成日の自動挿入、ユーザー名の取得、フォルダ名の活用など、実務でよく使うパターンを網羅しています。

以下の図は、解決策の全体像を示しています。

mermaidflowchart TB
  solution["解決策"] --> approach1["型選択基準<br/>の明確化"]
  solution --> approach2["表示名設定<br/>の手順化"]
  solution --> approach3["テンプレ連携<br/>のカタログ化"]

  approach1 --> result1["速見表で<br/>即座に選択"]
  approach2 --> result2["日本語 UI<br/>での運用"]
  approach3 --> result3["自動入力で<br/>効率化"]

  result1 --> goal["Properties<br/>機能の<br/>完全活用"]
  result2 --> goal
  result3 --> goal

これらの解決策により、Properties 機能を迷わず使いこなせるようになり、ノート管理の効率が大幅に向上します。

具体例

ここでは、実際のユースケース別に Properties の設定例を紹介します。

技術ブログ記事管理の例

技術ブログの記事を Obsidian で管理する場合のプロパティ設定です。

プロパティ定義

yaml---
title: Next.js 15 の新機能解説
author: 山田太郎
created: 2025-11-21
updated: 2025-11-21
published: false
tags: [nextjs, react, typescript]
category: フロントエンド
priority: 3
word_count: 5000
---

上記の YAML は、以下のようなプロパティ型で構成されています。

プロパティ説明
titleText記事タイトル
authorText著者名
createdDate作成日
updatedDate更新日
publishedCheckbox公開状態
tagsListタグ一覧
categoryTextカテゴリ
priorityNumber優先度(1-5)
word_countNumber文字数

Templater での自動化

Templater プラグインを使うと、以下のようにテンプレート化できます。

markdown---
title: <% tp.file.title %>
author: <% tp.user.name %>
created: <% tp.date.now("YYYY-MM-DD") %>
updated: <% tp.date.now("YYYY-MM-DD") %>
published: false
tags: []
category:
priority: 3
word_count: 0
---

このテンプレートを使えば、新規ノート作成時に自動的にプロパティが挿入され、タイトルやユーザー名、作成日が自動入力されます。

プロジェクト管理の例

タスクやプロジェクトを管理する場合のプロパティ設定です。

プロパティ定義

yaml---
task_name: API エンドポイントの実装
status: in_progress
assignee: 佐藤花子
due_date: 2025-11-30
start_date: 2025-11-15
estimated_hours: 8
actual_hours: 5
priority: high
dependencies: [[認証機能実装]]
labels: [backend, api, urgent]
---

このプロパティ構成により、タスクの進捗状況を視覚的に管理できます。

プロパティ説明
task_nameTextタスク名
statusTextステータス(todo/in_progress/done)
assigneeText担当者
due_dateDate期限日
start_dateDate開始日
estimated_hoursNumber見積時間
actual_hoursNumber実績時間
priorityText優先度(high/medium/low)
dependenciesLink依存タスク
labelsListラベル

表示名のカスタマイズ

内部キー名は英語で統一し、表示名を日本語にすることで、コードとしての可読性と UI の分かりやすさを両立できます。

Settings → Properties → Types で以下のように設定します:

内部キー名表示名
task_nameタスク名
statusステータス
assignee担当者
due_date期限日
start_date開始日
estimated_hours見積時間
actual_hours実績時間
priority優先度
dependencies依存タスク
labelsラベル

読書メモの例

読んだ本の情報を管理する場合のプロパティ設定です。

プロパティ定義

yaml---
book_title: リーダブルコード
author: Dustin Boswell
isbn: 978-4873115658
publisher: オライリージャパン
published_date: 2012-06-23
read_date: 2025-11-20
rating: 5
pages: 260
genre: [技術書, プログラミング]
status: completed
notes_count: 15
---

書籍情報を構造化して管理することで、後から検索やフィルタリングが簡単にできますね。

プロパティ説明
book_titleText書籍タイトル
authorText著者
isbnTextISBN
publisherText出版社
published_dateDate出版日
read_dateDate読了日
ratingNumber評価(1-5)
pagesNumberページ数
genreListジャンル
statusText読書状況
notes_countNumberメモ数

以下の図は、読書メモのデータフローを示しています。

mermaidflowchart LR
  book["書籍"] -->|読む| user["読者"]
  user -->|メモ作成| note["Obsidian ノート"]
  note -->|Properties で構造化| meta["メタデータ"]
  meta -->|検索・集計| dashboard["ダッシュボード"]
  dashboard -->|可視化| insights["読書傾向<br/>分析"]

このように Properties を活用することで、単なるメモから、検索可能で分析可能なデータベースへと進化させることができます。

Dataview プラグインとの連携例

Dataview プラグインを使えば、Properties を活用したクエリが可能になります。

未完了タスクの一覧表示

markdown```dataview
TABLE task_name as "タスク名", assignee as "担当者", due_date as "期限"
FROM "Projects"
WHERE status != "done"
SORT due_date ASC
```

このクエリにより、プロジェクトフォルダ内の未完了タスクを期限順に表示できます。

評価が高い書籍の一覧

markdown```dataview
TABLE book_title as "書籍", author as "著者", rating as "評価"
FROM "Books"
WHERE rating >= 4
SORT rating DESC
```

評価 4 以上の書籍を評価順に並べて表示できますね。

今月作成された記事の統計

markdown```dataview
TABLE created as "作成日", title as "タイトル", word_count as "文字数"
FROM "Articles"
WHERE created >= date(2025-11-01) AND created <= date(2025-11-30)
SORT created DESC
```

このように Dataview と組み合わせることで、Properties の真価が発揮されます。

実務での活用パターン

以下の表は、実務でよく使われる Properties の活用パターンをまとめたものです。

#ユースケース主要プロパティプラグイン連携
1技術ブログ管理title, tags, published, createdTemplater, Dataview
2タスク管理status, due_date, assignee, priorityTasks, Calendar
3読書記録book_title, author, rating, read_dateDataview, Charts
4プロジェクト管理status, dependencies, estimated_hoursDataview, Kanban
5論文管理authors, doi, conference, yearCitations, Zotero
6日記mood, weather, energy_level, dateCalendar, Heatmap

これらのパターンを参考にすれば、自分のユースケースに合った Properties 設計ができますね。

まとめ

Obsidian の Properties 機能は、YAML フロントマターを視覚的に編集できるだけでなく、型安全性と補完機能により、メタデータ管理の品質を大きく向上させます。

本記事では、型の選択基準、表示名のカスタマイズ方法、テンプレート連携のパターンを速見表形式で整理しました。技術ブログ管理、タスク管理、読書記録など、具体的なユースケース別の実例も紹介しましたので、すぐに実務で活用できるでしょう。

特に Dataview プラグインと組み合わせることで、Obsidian を単なるメモアプリから、検索可能で分析可能なナレッジデータベースへと進化させることができます。

Properties 機能を使いこなして、より効率的なノート管理を実現してくださいね。

関連リンク