속성은 노트에 대한 정보를 정리할 수 있게 해줘요. 속성에는 텍스트, 링크, 날짜, 체크박스, 숫자와 같은 구조화된 데이터가 포함돼요. 속성은 구조화된 데이터를 활용하여 유용한 작업을 수행할 수 있는 [[커뮤니티 플러그인]]과 함께 사용할 수도 있어요. ## 노트에 속성 추가하기 노트에 속성을 추가하는 방법은 여러 가지가 있어요: - **파일 속성 추가** [[명령어 팔레트|명령]]을 사용해요. - **`Cmd/Ctrl+;`** [[단축키|키보드 단축키]]를 사용해요. - **추가 작업** 메뉴(점 세 개 아이콘을 클릭하거나 탭을 우클릭하여 열 수 있음)에서 **파일 속성 추가**를 선택해요. - 파일의 맨 처음에 `---`를 입력해요. 속성을 추가하면 파일 상단에 속성 _이름_과 속성 _값_ 두 개의 입력란이 있는 행이 나타나요. 이름에는 원하는 것을 선택할 수 있어요. 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` 속성을 두 개 이상 가질 수 없어요. 값은 [[#텍스트|텍스트]], [[#숫자|숫자]], [[#체크박스|체크박스]], [[#날짜|날짜]], [[#날짜 및 시간|날짜 및 시간]] 또는 [[#목록|목록]]이 될 수 있어요. ### 텍스트 텍스트 속성은 한 줄의 텍스트를 포함해요. 텍스트 속성에서는 Markdown 서식이 렌더링되지 않아요. 텍스트 속성에서 해시태그를 사용해도 태그가 생성되지 않아요. 텍스트 속성에는 URL과 `[[Link]]` 구문을 사용한 [[내부 링크]]를 포함할 수 있어요. 텍스트 속성의 [[내부 링크]]는 따옴표로 감싸야 해요. 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` | [[소셜 미디어 링크 미리보기#Description\|Description]]을 참조하세요. | | `image` | [[소셜 미디어 링크 미리보기#Image\|Image]]를 참조하세요. | | `cover` | [[소셜 미디어 링크 미리보기#Image\|Image]]를 참조하세요. | ### 지원 중단된 속성 이 속성들은 Obsidian 1.4에서 지원 중단되었으며 최신 동등 속성으로 대체해야 해요. [[#기본 속성]]으로서의 지원은 Obsidian 1.9에서 중단돼요. | 속성 | 설명 | |-|-| | `tag` | `tags`의 지원 중단된 별칭이에요. | | `alias` | `aliases`의 지원 중단된 별칭이에요. | | `cssclass` | `cssclasses`의 지원 중단된 별칭이에요. | > [!tip] 보관함의 파일을 [[#기본 속성]] 형식으로 변환해야 하는 경우 [[마크다운 형식 불러오기]]를 사용하여 보관함 전체를 일괄 변경할 수 있어요.