RL RanceLee Tutorials
← 튜토리얼로 돌아가기

Obsidian Properties: 노트를 검색 가능하게 만들기

이 장에서는 Obsidian의 Properties에 대해 알아보겠습니다.

이전 장에서는 Obsidian을 더 강력하게 만드는 플러그인을 다뤘습니다. 이 장에서는 덜 화려하지만 매우 실용적인 기능인 각 노트에 메타데이터를 추가하는 방법을 다룹니다.


Properties란 무엇인가?

노트를 열고 오른쪽 상단의 점 세 개(⋯)를 클릭한 후 ‘속성 추가’를 선택하세요.

노트 상단에 표 같은 영역이 나타납니다. 왼쪽은 속성 이름, 오른쪽은 속성 값입니다. 왼쪽에서는 Obsidian의 내장 속성(예: 태그, 별칭)을 선택하거나 직접 이름을 입력하여 새 속성을 만들 수 있습니다. 오른쪽에는 해당 내용을 입력합니다.

정말 간단합니다. 코딩이 필요 없습니다.

YAML은 무엇인가요?

소스 모드(설정 → 편집기 → 기본 편집 모드 → 소스 모드)로 전환하면 속성이 실제로 이렇게 보입니다:

---
title: My Note Title
date: 2026-03-03
tags:
  - Obsidian
  - Tutorial
---

--- 줄 사이의 내용을 YAML frontmatter라고 하며, 데이터 형식입니다. 하지만 직접 작성할 필요는 없습니다—Obsidian의 시각적 편집기가 모든 것을 처리합니다. 속성 패널에서 클릭하고 선택하면 기본 코드가 자동으로 생성됩니다.

그냥 이런 것이 있다는 것만 알아두세요. 일상적인 사용에서는 소스 코드를 건드릴 필요가 없습니다.


Properties는 무엇에 좋을까요?

이렇게 물을 수도 있습니다: 본문에 모든 것을 쓰면 되지, 왜 속성이라는 추가 계층을 두는 걸까요?

세 가지 이점이 있습니다.

1. 더 정확한 검색

일반 검색은 전체 텍스트 검색입니다. ’tutorial’을 검색하면 본문에 ’tutorial’이라는 단어가 포함된 모든 노트가 나타나며, 잠재적으로 방대한 목록이 나올 수 있습니다.

하지만 속성에 categories: Tutorial을 설정하면 Obsidian의 검색 구문을 사용하여 정확하게 필터링할 수 있습니다:

[categories: Tutorial]

이렇게 하면 ‘Tutorial’로 분류된 노트만 반환되며, 본문에서 ’tutorial’이라는 단어를 우연히 언급한 노트는 제외됩니다.

Properties는 구조화된 데이터이고, 본문은 비구조화된 데이터입니다. 노트가 수백 개가 되면 이 차이는 점점 더 중요해집니다.

2. 자동 템플릿 채우기

이 기능은 템플릿과 함께 작동합니다. 템플릿에 대해서는 다음 장에서 자세히 다루겠지만, 여기서 간단히 미리 보겠습니다:

템플릿에 date: {{date}}와 같은 속성을 미리 설정할 수 있습니다. 해당 템플릿에서 새 노트를 만들 때마다 날짜가 자동으로 현재 날짜로 채워집니다. 제목, 카테고리와 같은 반복적인 속성도 마찬가지로 템플릿이 자동으로 채워줍니다.

3. 웹 클리핑 및 가져오기에서 자동 메타데이터

브라우저 클리핑 플러그인(예: Obsidian Web Clipper)을 사용하여 웹 기사를 Obsidian에 저장하면, 클리핑된 노트에 자동으로 속성이 포함됩니다—원본 제목, 링크, 저장 날짜 및 기타 정보가 속성에 저장되어 콘텐츠의 출처를 추적하는 데 도움이 됩니다.


자주 사용되는 Properties

원하는 속성은 무엇이든 만들 수 있지만, 가장 일반적으로 사용되는 몇 가지가 있습니다. 이에 대해 알아두는 것이 좋습니다.

1. title

이름에서 알 수 있듯이 노트의 제목입니다.

참고: title 속성은 파일 이름과 다를 수 있습니다. 파일 이름은 파일 목록에서 보이는 것이고, title 속성은 노트의 ‘공식 제목’입니다.

예를 들어, 2026-03-03 Obsidian-Properties.md라는 파일이 있지만 title 속성은 Obsidian Properties: Make Notes Searchable입니다—파일 이름의 날짜는 정렬을 위한 것이며 제목에 나타날 필요가 없습니다.

개인적인 조언: 특별한 번호 매기기 요구 사항이 없다면 제목과 파일 이름을 동일하게 설정하여 혼동을 피하세요.

2. date

노트의 생성 날짜 또는 발행 날짜를 기록합니다.

수동으로 입력하는 경우 형식은 YYYY-MM-DD입니다(예: 2026-03-03).

하지만 팁이 있습니다: 템플릿에서 date 속성을 설정하는 경우 다음과 같이 작성하는 것이 좋습니다:

date: "{{date}}"

이렇게 하면 템플릿에서 새 노트를 만들 때마다 {{date}}가 노트를 만든 날짜로 자동 대체됩니다. 수동 입력이 필요 없고 실수도 없습니다.

이 기능은 다음 장의 템플릿에서 자세히 다룹니다.

3. aliases

이 속성은 매우 유용합니다—꼭 알아두세요.

별칭을 사용하면 노트에 여러 이름을 부여할 수 있습니다. 우리는 종종 같은 대상을 다른 이름으로 부르는데, 이때 별칭이 유용합니다.

예를 들어, 파일 이름이 ‘The Donald’인 도널드 트럼프에 관한 노트가 있습니다. 하지만 다른 노트에서는 그를 ‘Trump’, ‘Donald Trump’, ‘President Trump’, ‘Mr. Trump’ 등으로 언급할 수 있습니다.

별칭이 없으면 [[Trump]]를 사용하여 링크를 만들 때 Obsidian은 ‘Trump’라는 이름의 노트에 링크하려는 것으로 생각합니다. 하지만 그런 노트는 존재하지 않습니다—노트 이름은 ‘The Donald’입니다. 결과적으로 같은 사람을 가리키지만 링크는 다른 곳을 가리키게 됩니다.

별칭이 있으면 다릅니다. ‘The Donald’ 노트의 속성에 다음과 같이 작성합니다:

aliases:
  - Trump
  - Donald Trump
  - President Trump
  - Mr. Trump

이제 어느 노트에 있든 [[를 입력한 다음 ‘Trump’, ‘Donald Trump’, ‘Mr. Trump’를 입력하면 Obsidian이 ‘The Donald’ 노트에 링크하도록 제안합니다. 여러 이름, 하나의 항목.

이는 지식 베이스를 구축할 때 특히 유용합니다. 많은 개념에 대체 이름, 약어 또는 영어 이름이 있습니다. 별칭을 사용하여 관리하면 링크가 체계적으로 유지됩니다.

4. categories

노트에 ‘Book Notes’, ‘Tutorial’, ‘Random Thoughts’ 등과 같은 광범위한 카테고리를 표시합니다.

categories:
  - Obsidian Tutorial

카테고리는 주로 자신의 참고용으로, 같은 유형의 노트를 빠르게 필터링하는 데 도움이 됩니다. 나중에 노트를 블로그에 게시하면 많은 블로깅 시스템(예: Hugo, Hexo)이 이 속성을 읽어 카테고리 페이지를 생성합니다.

5. tags

태그는 대부분에게 익숙합니다. Obsidian에서는 본문에 #tagname을 사용하여 태그를 추가하거나 속성에 통일하여 작성할 수 있습니다:

tags:
  - Obsidian
  - Tutorial
  - Note-taking

속성에 태그를 작성하면 중앙 집중식 관리의 장점이 있습니다—본문을 검색하지 않고도 노트에 어떤 태그가 있는지 한눈에 알 수 있습니다.

하지만 솔직히 말해서, Obsidian에서 태그의 역할은 링크로 대체될 수 있습니다. 개념이 태그를 붙일 만큼 중요하다면, 그 개념에 대한 노트를 만들고 링크하는 것은 어떨까요? 링크는 더 유연하고 더 많은 내용을 담을 수 있습니다.

물론 태그에 익숙하다면 그대로 사용해도 전혀 문제없습니다. 태그와 링크는 충돌하지 않습니다—자신에게 맞는 것을 선택하세요.

6. 기타 유용한 Properties

위의 다섯 가지 외에도 유용하게 사용할 수 있는 몇 가지를 소개합니다:

cssclasses — 단일 노트에 특별한 CSS 스타일을 지정합니다. 예를 들어, 노트에 다른 글꼴이나 레이아웃을 사용하려면 이 속성을 사용자 정의 CSS와 함께 사용할 수 있습니다. 고급 기능이므로 초보자는 지금은 건너뛰어도 됩니다.

publish — Obsidian의 공식 게시 서비스(Obsidian Publish)를 사용하는 경우 이 속성은 노트의 게시 여부를 제어합니다. true는 게시, false는 게시하지 않음입니다.

description — 노트에 대한 간단한 설명 또는 요약입니다. 블로깅 시스템과 함께 사용하면 이 속성이 종종 기사 목록에서 미리보기 텍스트로 나타납니다.

또한 author, source, status(초안/완료) 등 필요한 속성을 자유롭게 만들 수 있습니다. Properties는 완전히 사용자 정의 가능하므로 유용한 것을 추가하세요.


요약

오늘 배운 내용:

  1. Properties란 무엇인가: 노트 상단의 구조화된 정보입니다. 점 세 개를 클릭하여 추가하며 코딩이 필요 없습니다.
  2. 사용하는 이유: 정확한 검색, 자동 템플릿 채우기, 웹 클리핑에서 자동 메타데이터.
  3. 자주 사용되는 Properties:
    • title — 파일 이름과 다를 수 있습니다.
    • date — 템플릿에서 {{date}}를 사용하여 자동 채우기.
    • aliases — 같은 노트를 가리키는 여러 이름, 링크에 필수적.
    • categories — 노트를 광범위한 카테고리로 그룹화.
    • tags — 중앙 집중식 관리, 하지만 링크가 대부분의 사용 사례를 대체할 수 있음.
  4. Properties는 완전히 사용자 정의 가능: 필요한 것을 추가하세요.

핵심 정리:

  • 별칭은 가장 가치 있는 속성입니다—링크 시스템의 훌륭한 동반자입니다.
  • 태그도 작동하지만, Obsidian에서는 링크가 더 강력합니다.
  • 처음부터 너무 많은 속성을 설정하지 마세요; 필요할 때 추가하세요.