プロパティを使ってノートの情報を整理できます。プロパティにはテキスト、リンク、日付、チェックボックス、数値などの構造化データが含まれます。プロパティは、構造化データを活用する便利な[[コミュニティプラグイン]]と組み合わせて使うこともできます。
## ノートにプロパティを追加する
ノートにプロパティを追加するにはいくつかの方法があります:
- **ファイルプロパティを追加**[[コマンドパレット|コマンド]]を使用する。
- **`Cmd/Ctrl+;`** [[ホットキー|ショートカットキー]]を使用する。
- **その他のオプション**メニュー(三点アイコンまたはタブの右クリックで表示)から**ファイルプロパティを追加**を選択する。
- ファイルの先頭に `---` と入力する。
プロパティを追加すると、ファイルの上部にプロパティの_名前_と_値_の2つの入力欄を持つ行が表示されます。
名前には好きなものを選べます。Obsidianにはいくつかのデフォルトプロパティが用意されています: `tags`、`cssclasses`、`aliases` です。
プロパティ名を選んだら、値を入力できます。
### プロパティタイプ
名前と値に加えて、プロパティには_タイプ_もあります。プロパティのタイプによって、格納できる値の種類とObsidianでの処理方法が決まります。プロパティのタイプを変更するには、プロパティ名の横にあるタイプアイコンをクリックし、別のオプションを選択します。[[プロパティビュー]]コアプラグインを使ってプロパティタイプを管理することもできます。
Obsidianは以下のプロパティタイプをサポートしています:
- **[[#テキスト]]**
- **[[#リスト]]**
- **[[#数値]]**
- **[[#チェックボックス]]**
- **[[#日付]]**
- **[[#日付と時刻]]**
- **[[#タグ]]**
プロパティ名にプロパティタイプが割り当てられると、保管庫内のその名前を持つすべてのプロパティが同じタイプを使用します。
## 高度な使い方
### プロパティを検索する
プロパティには独自の[[検索|検索構文]]があり、他の検索語や演算子と組み合わせて使用できます。[[検索#プロパティを検索する|プロパティの検索構文を参照]]してください。
### テンプレート
[[テンプレート|テンプレート]]にプロパティを追加できます。
アクティブなノートにテンプレートを挿入すると、テンプレートのすべてのプロパティがノートに追加されます。Obsidianはノートに既に存在するプロパティとテンプレートのプロパティを統合します。 ^templates-properties
### プロパティのリネーム
[[プロパティビュー|すべてのプロパティビュー]]でプロパティを右クリックすることで、プロパティをリネームできます。
### 表示モード
**[[設定]] → エディタ → ドキュメント内プロパティ**でノート内のプロパティの表示方法を変更できます。オプションは以下の通りです:
- **表示**(デフォルト) – プロパティがある場合、ノートの上部に表示します。
- **非表示** – プロパティを非表示にしますが、[[プロパティビュー]]を使ってサイドバーに表示できます。
- **ソース** – プレーンテキストのYAML形式でプロパティを表示します。
### CSSスニペット
[[CSSスニペット]]を使用して特定のノートの外観を変更できます。
### 未サポート
現在Obsidianでサポートされていない機能がいくつかあります:
- **ネストされたプロパティ**: ネストされたプロパティを表示するには、[[ビューと編集モード#ソースモード|ソースモード]]の使用をお勧めします。
- **プロパティの一括編集**: [[プロパティビュー]]以外での本格的な一括編集には、VSCode、スクリプト、コミュニティプラグインなどの一括編集ツールの使用をお勧めします。
- **プロパティ内のMarkdown**: これは意図的な制限です。プロパティは人間と機械の両方が読める小さな原子的な情報を扱うことを目的としているためです。
## ショートカットキー
### プロパティを追加する
| アクション | ショートカットキー |
|---|---|
|新しいプロパティを追加|`Cmd + ;`|
### プロパティ間を移動する
プロパティがフォーカスされているとき
| アクション | ショートカットキー |
|---|---|
|次のプロパティにフォーカス|`Down arrow` または `Tab`|
|前のプロパティにフォーカス|`Up arrow` または `Shift+Tab`|
|エディタにジャンプ|`Alt+Down arrow`|
### プロパティを選択する
| アクション | ショートカットキー |
|---|---|
|選択範囲を上に拡張|`Shift+Up arrow`|
|選択範囲を下に拡張|`Shift+Down arrow`|
|すべてを選択|`Cmd+A`|
### プロパティを編集する
| アクション | ショートカットキー |
|---|---|
|プロパティ名を編集|`Left arrow`|
|プロパティ値を編集|`Right arrow`|
|プロパティにフォーカス|`Escape`|
|プロパティを削除|`Cmd+Backspace`<br><br>プロパティが選択されている場合は、選択されたものが削除されます。|
|元に戻す|`Cmd+Z`|
|やり直す|`Cmd+Shift+Z`|
### Vim(上級者向け)
| アクション | ショートカットキー |
|---|---|
|下に移動|`j`|
|上に移動|`k`|
|キーにフォーカス|`h`|
|値にフォーカス|`l`|
|値にフォーカス(カーソルを末尾に)|`A`|
|値にフォーカス(カーソルを先頭に)|`i`|
|新しいプロパティを作成|`o`|
## プロパティの形式
プロパティはファイルの先頭に[YAML](https://yaml.org/)形式で保存されます。YAMLは人間とコンピュータの両方にとって読みやすい一般的な形式です。
プロパティ名と値はコロンとスペースで区切られます:
```yaml
---
name: value
---
```
各名前と値のペアの順序は問いませんが、ノート内で各名前は一意でなければなりません。例えば、`tags`プロパティを複数持つことはできません。
値には[[#テキスト|テキスト]]、[[#数値|数値]]、[[#チェックボックス|チェックボックス]]、[[#日付|日付]]、[[#日付と時刻|日付と時刻]]、[[#リスト|リスト]]を使用できます。
### テキスト
テキストプロパティは1行のテキストを含みます。テキストプロパティではMarkdownの書式は反映されません。テキストプロパティ内でハッシュタグを使用してもタグは作成されません。
テキストプロパティにはURLや`[[リンク]]`構文を使った[[内部リンク]]を含めることができます。テキストプロパティ内の[[内部リンク]]は引用符で囲む必要があります。手動で内部リンクをプロパティに入力した場合、Obsidianは自動的に引用符を追加しますが、テンプレートプラグインを使用する場合は注意して追加してください。
```yaml
---
title: A New Hope
link: "[[Episode IV]]"
url: https://www.example.com
---
```
### リスト
リストプロパティは複数の値を含みます。リスト内の各値はハイフン(-)とスペースに続いて独自の行に表示されます。
リストの値にはテキスト、数値、[[内部リンク]]を含めることができます。リストプロパティで[[内部リンク]]を使用する場合は、引用符で囲んでください。
```yaml
---
cast:
- Mark Hamill
- Harrison Ford
- Carrie Fisher
links:
- "[[Link]]"
- "[[Link2]]"
---
```
### 数値
数値タイプのプロパティは常にリテラルの数値でなければならず、演算子を含む式は使用できません。整数と小数の両方が使用できます。
```yaml
---
year: 1977
pie: 3.14
---
```
### チェックボックス
チェックボックスプロパティは `true` または `false` のいずれかです。ライブプレビューでは、チェックボックスとして表示されます。
```yaml
---
favorite: true
reply: false
last: # 不定値。通常falseとして扱われます
```
### 日付
日付プロパティは以下の形式で保存されます:
```yaml
---
date: 2020-08-21
---
```
日付ピッカーはオペレーティングシステムのデフォルトの日付と時刻の形式に従います。システム環境設定で変更できます:
> [!info]- Windows
> **[[設定]] → 時刻と言語 → 言語と地域 → 地域の形式 → 形式の変更**
>
> ![[Windows-OS-DateTime.png#interface]]
> [!info]- Mac OS
> **システム環境設定 → 言語と地域 → 日付の形式**
>
> ![[Mac-OS-DateTime.png|450]]
[[デイリーノート]]プラグインが有効な場合、日付プロパティはその日付に対応するデイリーノートへの内部リンクとしても機能します。
![[デイリーノート#^daily-notes-date]]
### 日付と時刻
日付と時刻プロパティは日付と特定の時刻の両方を含み、以下の形式で保存されます:
```yaml
---
time: 2020-08-21T10:30:00
---
```
[[#日付|日付プロパティ]]と同様に、日付と時刻のピッカーはオペレーティングシステムのデフォルトの形式に従います。システム環境設定で変更できます。
### タグ
タグプロパティは `tags` プロパティ専用に使用される特別なプロパティタイプです。このプロパティタイプは他のプロパティに割り当てることはできません。
タグプロパティはリスト形式で、各タグはハイフン(-)とスペースに続いて独自の行に記述されます。
```yaml
---
tags:
- journal
- personal
- draft
---
```
`tags` プロパティはObsidianの[[#デフォルトプロパティ]]の一つです。Obsidianでのタグの使用方法については[[タグ]]を参照してください。
### JSONプロパティ
プロパティの定義にはYAMLの使用を推奨しますが、[JSON](https://www.json.org/)を使って定義することもできます:
```json
---
{
"tags": ["journal"],
"publish": false
}
---
```
JSONブロックは読み取り、解釈された後、YAMLとして保存されることに注意してください。
## デフォルトプロパティ
Obsidianにはデフォルトプロパティのセットが用意されています:
| プロパティ | タイプ | 説明 |
| ------------ | ---- | ------------------------------------------------------------ |
| `tags` | リスト | [[タグ\|タグ]]を参照。 |
| `aliases` | リスト | [[エイリアス]]を参照。 |
| `cssclasses` | リスト | [[CSSスニペット]]を使って個々のノートにスタイルを適用できます。 |
### Obsidian Publish用のプロパティ
以下のデフォルトプロパティは[[Obsidian Publishの概要|Obsidian Publish]]で使用できます:
| プロパティ | 説明 |
| ------------- | ---------------------------------------------------------------------------------------------------------- |
| `publish` | [[コンテンツの公開#公開するノートを自動的に選択する\|公開するノートを自動的に選択する]]を参照。 |
| `permalink` | [[パーマリンク\|パーマリンク]]を参照。 |
| `description` | [[ソーシャルメディアリンクプレビュー#説明\|説明]]を参照。 |
| `image` | [[ソーシャルメディアリンクプレビュー#画像\|画像]]を参照。 |
| `cover` | [[ソーシャルメディアリンクプレビュー#画像\|画像]]を参照。 |
### 非推奨プロパティ
これらのプロパティはObsidian 1.4で非推奨となり、最新の同等のものに置き換える必要があります。[[#デフォルトプロパティ]]としてのサポートはObsidian 1.9で廃止されました。
| プロパティ | 説明 |
|-|-|
| `tag` | `tags` の非推奨エイリアス。 |
| `alias` | `aliases` の非推奨エイリアス。 |
| `cssclass` | `cssclasses` の非推奨エイリアス。 |
> [!tip] 保管庫内のファイルを[[#デフォルトプロパティ]]の形式に変換する必要がある場合は、[[Markdownフォーマットインポーター]]を使って保管庫全体を一括変換できます。