Obsidian의 속성을 사용하면 노트에 관한 정보를 구성하여 텍스트, 링크, 날짜 및 숫자와 같은 구조화된 데이터를 추적하기가 쉬워집니다. 속성은 구조화된 데이터를 활용하여 다양한 작업을 수행하기 위해 [[커뮤니티 플러그인|커뮤니티 플러그인]]과 결합할 수도 있습니다.
## Add properties to a note
노트에 속성을 추가하는 방법은 여러 가지가 있습니다:
- **파일 속성 추가(Add file property)** 명령을 [[명령어 팔레트|명령어 팔레트]]에서 사용합니다.
- `Cmd/Ctrl+;` 키 [[유저 인터페이스/단축키|단축키]]를 사용합니다.
- **더 많은 작업** 메뉴에서 **파일 속성 추가(Add file property)**를 선택합니다(세 개의 점 아이콘을 클릭하거나 탭을 오른쪽 클릭하여 메뉴를 엽니다).
- 파일 맨 위에 `---`를 입력합니다.
한 번 속성을 추가하면 파일 맨 위에 속성 _이름_ 과 속성 _값_ 두 가지 입력란이 나타납니다.
속성 이름은 자유롭게 지정할 수 있지만 Obsidian은 `tags`, `cssclasses`, `aliases`와 같은 여러 기본 속성을 제공합니다.
속성 이름을 선택한 후 값을 할당할 수 있습니다.
### Property types
Obsidian의 속성은 이름과 값 외에도 속성 유형을 가지고 있습니다. 속성 유형은 저장할 수 있는 값의 종류를 정의합니다. 속성의 유형을 변경하려면 속성 아이콘을 클릭하거나 **파일 속성 편집**(**Edit file property**) 명령을 사용하십시오.
Obsidian은 다음과 같은 속성 유형을 지원합니다:
- **Text**
- **List**
- **Number**
- **Checkbox**
- **Date**
- **Date & time**
한 번 속성 유형이 속성에 할당되면 해당 이름의 모든 속성이 동일한 속성 유형을 가졌다고 가정합니다.
## Advanced uses
### Links
**텍스트** 및 **리스트** 유형의 속성에는 `[[Link]]` 구문을 사용하여 URL 및 [[내부 링크|내부 링크]]를 포함시킬 수 있습니다.
### Search properties
속성은 다른 검색 용어 및 연산자와 함께 사용할 수 있는 별도의 [[검색|검색 구문]]을 가지고 있어 다른 검색 조건 및 연산자와 함께 사용할 수 있습니다. [[검색#Search properties|속성 검색 구문]]을 확인하세요.
### Templates
[[템플릿|템플릿]]에 속성을 추가할 수 있습니다. 템플릿을 활성 노트에 삽입하면 템플릿의 모든 속성이 노트에 추가됩니다. Obsidian은 노트에 이미 존재하는 속성을 템플릿의 속성과 병합합니다.
### Display modes
노트에서 속성의 표시 방법을 변경할 수 있습니다. **설정 → 편집기 → 문서 내 속성**(**Settings → Editor → Properties in document**)으로 이동하여 변경할 수 있습니다. 다음 옵션은:
- **가시적(Visible)** (기본값) - 노트 상단에 속성을 표시합니다(있는 경우).
- **숨김** - 속성을 숨깁니다. 여전히 [[프로퍼티 보기]]를 통해 사이드바에서 표시할 수 있습니다.
- **소스** - 속성을 일반 텍스트 YAML 형식으로 표시합니다.
### Not supported
Obsidian에서는 다음과 같은 몇 가지 기능을 지원하지 않습니다:
- **중첩된 속성** - 중첩된 속성을 보려면 소스 표시를 권장합니다.
- **대량 속성 편집** - Python 스크립트와 같은 커뮤니티 제작 도구로 이를 달성할 수 있습니다.
- **속성 내의 마크다운** - 이것은 속성이 작고 원자적인 정보를 위해 만들어졌기 때문에 의도적으로 제한된 기능입니다.
## Hotkeys
### Add a property
| Action | Hotkey |
|---|---|
|새 속성 추가|`Cmd/Ctrl + ;`|
### Navigate between properties
When a property is focused
| Action | Hotkey |
|---|---|
|다음 속성 포커스|`Down arrow` or `Tab`|
|이전 속성 포커스|`Up arrow` or `Shift+Tab`|
|에디터로 이동|`Alt+Down arrow`|
### Select properties
| Action | Hotkey |
|---|---|
|선택 확장(위쪽으로)|`Shift+Up arrow`|
|선택 확장(아래로)|`Shift+Down arrow`|
|모두 선택|`Cmd+A`|
### Edit properties
| Action | Hotkey |
|---|---|
|속성 이름 편집|`Left arrow`|
|속성 값 편집|`Right arrow`|
|속성 포커스|`Escape`|
|속성 삭제|`Cmd+Backspace`<br><br>선택한 속성이 있는 경우 선택 항목을 삭제합니다.|
|실행 취소|`Cmd+Z`|
|다시 실행|`Cmd+Shift+Z`|
### Vim (advanced)
| Action | Hotkey |
|---|---|
|아래로 이동|`j`|
|위로 이동|`k`|
|키 포커스|`h`|
|값 포커스|`l`|
|값 포커스(커서 끝)|`A`|
|값 포커스(커서 시작)|`i`|
|새로운 속성 생성|`o`|
## Property format
속성은 사람과 기계 모두 읽을 수 있는 널리 사용되는 [YAML](https://yaml.org/) 형식으로 저장됩니다.
속성 이름은 콜론 뒤에 공백이 따라오는 형식으로 값을 나타냅니다:
```yaml
---
name: value
---
```
각 이름-값 쌍의 순서는 중요하지 않지만 각 이름은 노트 내에서 고유해야 합니다. 예를 들어 `tags` 속성은 하나 이상 가질 수 없습니다.
값은 텍스트, 숫자, true 또는 false 또는 값의 컬렉션(배열)일 수 있습니다.
```yaml
---
title: A New Hope
year: 1977
favorite: true
cast:
- Mark Hamill
- Harrison Ford
- Carrie Fisher
---
```
**텍스트** 및 **목록** 유형 속성의 내부 링크는 따옴표로 묶어야 합니다. Obsidian은 속성에 내부 링크를 수동으로 입력하면 자동으로 이러한 링크를 추가하지만 템플릿 플러그인을 사용할 때는 주의해서 추가하세요.
```yaml
---
link: "[[Link]]"
linklist:
- "[[Link]]"
- "[[Link2]]"
---
```
**Date** 및 **Date & time** 유형의 속성은 다음 형식으로 저장됩니다:
```yaml
---
date: 2020-08-21
time: 2020-08-21T10:30:00
---
```
날짜 선택기는 운영 체제의 기본 날짜 및 시간 형식을 따릅니다. 시스템 환경 설정에서 변경할 수 있습니다:
> [!info]- Windows
> **설정 → 시간 및 언어 → 언어 및 지역 → 지역 형식 → 형식 변경**(**Settings → Time & Language → Language & Region → Regional Format → Change Formats**)
>
> ![[Windows OS DateTime.png]]
> [!info]- Mac OS
> **시스템 환경 설정 → 언어 및 지역 → 날짜 형식**(**System Preferences → Language and Region → Date format**)
>
> ![[Mac OS DateTime.png|450]]
### JSON Properties
속성을 정의할 때 YAML을 사용하는 것이 좋지만 [JSON](https://www.json.org/)을 사용하여 속성을 정의할 수도 있습니다:
```json
---
{
"tags": "journal",
"publish": false
}
---
```
JSON 블록은 YAML로 읽혀지고 해석되며 저장됩니다.
## Default properties
Obsidian은 기본 속성 집합을 제공합니다:
| Property | Description |
|-|-|
| `tags` | [[Tags|Tags]]를 참조하세요. |
| `aliases` | [[별칭]]를 참조하세요. |
| `cssclasses` | [[CSS 스니펫]]를 사용하여 개별 노트를 스타일링할 수 있습니다. |
### Deprecated properties
이러한 속성은 1.4에서 지원 중단되었습니다. 더 이상 사용하지 마십시오:
| Property | Description |
|-|-|
| `tag` | `tags`의 지원 중단된 별칭입니다. |
| `alias` | `aliases`의 지원 중단된 별칭입니다. |
| `cssclass` | `cssclasses`의 지원 중단된 별칭입니다. |
### Properties for Obsidian Publish
다음 속성은 [[Obsidian Publish 소개|Obsidian Publish]]에서 사용됩니다:
| Property | Description |
|-|-|
| `publish` | 참조 [[노트 게시 및 게시 취소#Automatically select notes to publish]]. |
| `permalink` | 참조 [[노트 게시 및 게시 취소#Permalinks]]. |
| `description` | 참조 [[소셜 미디어 링크 미리보기#Description]]. |
| `image` | 참조 [[소셜 미디어 링크 미리보기#Image]]. |
| `cover` | 참조 [[소셜 미디어 링크 미리보기#Image]]. |