Obsidian 작업 형식 치트시트

작업 줄의 구조

작업은 체크박스가 있는 목록 항목입니다. 설명 뒤에 필드가 오고, 각 필드는 기호와 값으로 이루어집니다. Obsidian Tasks는 줄을 오른쪽부터 읽으므로 필드는 텍스트 뒤, 줄 끝에 두어야 합니다. 인식할 수 없는 텍스트가 두 필드 사이에 있으면 그 지점에서 읽기가 멈춥니다.

같은 작업을 인라인 형식별로 나란히 보면 다음과 같습니다.

- [ ] Pay rent ⏫ 🔁 every month ➕ 2026-01-02 ⏳ 2026-01-14 📅 2026-01-15

- [ ] Pay rent  [priority:: high]  [repeat:: every month]  [created:: 2026-01-02]  [scheduled:: 2026-01-14]  [due:: 2026-01-15]

- [ ] Pay rent #project/Home @bank ⏫ 📅 2026-01-15 09:00 [repeat:: every month]

필드 나란히 비교

날짜는 항상 YYYY-MM-DD 형식입니다. Dataview 열은 대괄호를 사용합니다. Obsidian Tasks와 Dataview는 소괄호 (due:: 2026-01-15)도 읽지만, Task Genius는 대괄호만 읽습니다. Task Genius는 이모지와 대괄호 형식을 모두 읽으므로, 그 열에는 추가되거나 표기가 다른 항목만 적었습니다.

화면이 좁으면 옆으로 스크롤하세요.

Obsidian Tasks가 필드를 쓰는 순서

Obsidian Tasks가 줄을 쓸 때는 ID, 선행 작업, 우선순위, 반복, 완료 시 동작을 먼저 놓고, 그다음 생성일, 시작일, 예정일, 마감일, 마지막으로 취소일과 완료일을 놓습니다. 손으로 다른 순서로 써도 모든 필드가 줄 끝에 있으면 읽힙니다.

상태 문자

대괄호 안의 문자가 상태입니다. 공통으로 통하는 것은 공백과 x뿐입니다. 나머지는 관례이며, 플러그인, 테마, 상태 컬렉션이 의미를 부여합니다.

Obsidian Tasks에서 설정하지 않은 문자는 Unknown 상태로 표시됩니다. 플러그인의 Custom Statuses 설정에서 추가하거나 미리 만들어진 상태 컬렉션을 불러오세요.

Task Genius는 x와 X만 완료로 처리합니다. TaskNotes 파일은 체크박스 문자를 전혀 쓰지 않고 status 속성을 둡니다. 아래에서 다룹니다.

반복

반복은 형식 간 차이가 가장 큰 부분입니다. 같은 주간 작업을 네 가지로 쓰면 다음과 같습니다.

- [ ] Water plants 🔁 every week on Sunday when done 📅 2026-01-18

- [ ] Water plants  [repeat:: every week on Sunday when done]  [due:: 2026-01-18]

- [ ] Water plants [recurrence:: FREQ=WEEKLY;BYDAY=SU] [due:: 2026-01-18]

recurrence: "DTSTART:20260118;FREQ=WEEKLY;BYDAY=SU"
recurrence_anchor: completion

Obsidian Tasks가 이해하는 규칙

모든 규칙은 every로 시작합니다. 원래 날짜가 아니라 끝낸 날부터 계산하려면 when done을 붙이세요.

every 3 days
every 10 days when done
every weekday
every week on Sunday
every week on Tuesday, Friday
every 2 weeks
every 3 weeks on Friday
every 2 months
every month on the 1st
every month on the last
every month on the last Friday
every month on the 2nd last Friday
every January on the 15th
every April and December on the 1st and 24th
every year

완료 시의 동작

• Obsidian Tasks: 반복 작업을 체크하면 그 줄이 완료로 바뀌고, 날짜를 앞으로 옮긴 새 줄이 추가됩니다. 기본값은 원래 줄 위이며, 설정으로 아래에 둘 수도 있습니다.
• Obsidian Tasks: 반복 작업에는 마감일, 예정일, 시작일 중 적어도 하나가 필요합니다. 없으면 규칙이 옮길 날짜가 없습니다.
• Obsidian Tasks: 월간 규칙에서 존재하지 않는 날짜(4월 31일)가 되면 그 달의 마지막 유효한 날로 앞당겨집니다. 31일을 명시한 규칙은 31일이 없는 달을 건너뜁니다.
• Obsidian Tasks: 새 줄에는 ID와 선행 작업 필드가 이어지지 않으므로 의존 관계가 영원히 막히지 않습니다.
• TaskNotes: 파일은 하나의 작업으로 유지됩니다. 완료한 날짜와 건너뛴 날짜는 complete_instances와 skipped_instances에 들어가고 일정이 앞으로 갑니다.
• Task Genius: 다음 날짜는 iCalendar 규칙이나 every 2 weeks 같은 간단한 문구로 계산합니다. every weekday나 the last Friday of the month 같은 Obsidian Tasks의 복잡한 문구는 같은 방식으로 읽히지 않으므로, 의존하기 전에 몇 가지를 시험해 보세요.
• 반복 작업은 데일리 노트에 두지 마세요. 데일리 노트의 반복 줄은 매일의 노트에 복사됩니다.

작업 파일: TaskNotes frontmatter

TaskNotes는 노트 하나에 작업 하나를 저장합니다. 정보는 YAML frontmatter에 있고 본문은 자유로운 텍스트입니다. 플러그인 설정에서 정한 태그나 속성(기본값은 task 태그)이 있는 파일이 작업으로 취급됩니다.

---
tags:
  - task
title: Review quarterly report
status: in-progress
priority: high
due: 2026-01-15
scheduled: 2026-01-14
contexts:
  - office
projects:
  - "[[Q1 Planning]]"
timeEstimate: 90
recurrence: "DTSTART:20260115;FREQ=MONTHLY;BYMONTHDAY=15"
recurrence_anchor: scheduled
---

Notes, links and a checklist go in the body.

속성

title: Review quarterly report

status: in-progress

priority: high

due: 2026-01-15

scheduled: 2026-01-14T09:00

completedDate: 2026-01-15

dateCreated: 2026-01-02T08:00:00Z

dateModified: 2026-01-15T10:30:00Z

tags: [task, finance]

contexts: [office]

projects: ["[[Q1 Planning]]"]

timeEstimate: 90

recurrence: "FREQ=WEEKLY;BYDAY=MO,WE,FR"

recurrence_anchor: completion

complete_instances: ["2026-01-08"]

skipped_instances: ["2026-01-22"]

- uid: "Tasks/Draft report.md"
  reltype: FINISHTOSTART

속성 이름은 설정입니다. 플러그인에서 due를 deadline으로 바꾸면 파일도 deadline을 써야 합니다.

항목이 하나뿐이어도 목록은 목록이어야 합니다. 목록이 와야 할 자리에 스칼라 값을 쓰는 것이 작업 파일이 뷰에 나타나지 않는 가장 흔한 원인입니다.

저녁 시간을 통째로 잡아먹는 함정

• Obsidian Tasks는 한 번에 한 형식만 읽고 씁니다. 설정이 Dataview이면 다시 바꿀 때까지 자체 이모지를 읽지 못합니다.
• Dataview에는 콜론 두 개가 필요합니다. [due:: 2026-01-15]가 맞고, 콜론 하나는 필드가 아닙니다.
• 괄호는 짝이 맞아야 합니다. [due:: 2026-01-15)는 읽히지 않습니다.
• Dataview 방식에서 Obsidian Tasks의 키는 대소문자를 구분합니다. repeat, dependsOn, onCompletion은 되지만 Repeat와 dependson은 안 됩니다. Task Genius는 대소문자를 구분하지 않고 키를 맞춥니다.
• 완료일 키는 completion입니다. [done:: 2026-01-15]는 그저 알 수 없는 필드입니다.
• Dataview는 마감일 약식 표기로 🗓️를 문서화하지만 Obsidian Tasks는 📅를 씁니다. 이모지 날짜를 Dataview로 조회한다면 먼저 사용 중인 버전에서 시험해 보세요. 대괄호 필드는 이 문제를 피합니다.
• 붙여넣은 텍스트에는 줄바꿈 없는 공백이나 이모지 뒤의 변형 선택자가 섞일 수 있습니다. Obsidian Tasks는 이를 읽지 못하는데, 화면에서는 줄이 멀쩡해 보입니다.
• Dataview의 약식 표기는 날짜 다섯 가지뿐입니다. 우선순위와 반복에는 약식이 없어서 대괄호 형식이 필요합니다.
• Obsidian Tasks의 #task 같은 전역 필터를 설정하면 그 태그가 없는 모든 체크박스를 무시합니다. 작업이 쿼리에서 사라졌다면 이것이 원인인 경우가 많습니다.
• 펜스 코드 블록 안의 체크박스 줄은 어떤 플러그인에서도 작업이 아닙니다.

신뢰할 수 있는 출처

플러그인은 바뀝니다. 이 페이지의 내용이 사용 중인 버전과 맞지 않아 보이면, 이 페이지보다 아래 문서를 믿으세요.

• Obsidian Tasks 문서: Tasks Emoji Format
• Obsidian Tasks: Dataview Format
• Obsidian Tasks 문서: Recurring Tasks
• Obsidian Tasks: Statuses
• Dataview: Metadata on Tasks and Lists
• Dataview: Adding Metadata (inline fields)
• Task Genius 문서
• GitHub의 Task Genius
• TaskNotes 문서
• TaskNotes: Property Types Reference

자주 묻는 질문