태스크와 쿼리 블록

태스크

태스크를 어떻게 켜고 끄나요?

기본으로 켜져 있습니다. 설정 > 일반 > 태스크 > 태스크 활성화가 볼트 전역 색인과 활동 표시줄의 태스크 아이콘을 함께 제어합니다.

체크박스 네 상태가 무엇인가요?

- [ ] 할 일, - [/] 진행 중, - [x] 완료, - [-] 취소됨. 체크박스를 클릭하면 앞의 셋을 돕니다. 취소됨은 일부러 그 고리에서 빼 놓았습니다 — 에디터에서 /cancel-task를, 또는 아젠다 행 메뉴의 태스크 취소를 쓰십시오 — 실수로 한 번 더 클릭해서 도달할 수 없게 하려는 것입니다.

[/]와 [-]는 GitHub Flavored Markdown의 일부가 아니라서, 그것을 모르는 에디터는 체크박스 대신 [/]를 그대로 보여 줍니다. 줄 자체는 절대 사라지지 않습니다.

이모지를 입력하지 않고 기한을 정하려면?

세 가지 방법이 있고 모두 같은 📅2026-09-30을 씁니다.

• 낱말 트리거 — due:2026-09-30(또는 due:t, due:m, due:+3, due:9/30)을 쓰고 공백을 넣습니다
• 말하듯 쓰기 — “by friday”나 “내일”이라고 씁니다. Baram이 인식한 부분에 밑줄을 긋고 Tab으로 확정합니다
• 슬래시 명령 — /due가 달력을 엽니다

sched: / /sched가 ⏳를, start: / /start가 🛫를 같은 방식으로 정합니다.

우선순위는 어떻게 정하나요?

prio:1부터 prio:5까지(또는 짧게 !1…!5)를 쓰고 공백을 넣거나 /priority를 씁니다. P1이 가장 급합니다 — 🔺 ⏫(없음)🔽 ⏬.

태스크를 반복하게 하려면?

/repeat입니다 — 규칙에 공백이 들어가서 낱말 트리거가 될 수 없으므로 이것이 유일한 입력 경로입니다. 규칙은 every day, every 2 weeks, every weekday, every week on Monday, every month on the 15th 같은 모양입니다.

반복 태스크를 완료하거나 취소하면 앞으로 굴러갑니다 — 날짜가 다음 차례로 옮겨지고 상태가 [ ]로 돌아가며, 모두 같은 줄에서 일어납니다. 칩이 *(no date to move)*라고 하면 규칙은 있는데 굴릴 날짜가 없는 것이고, *(not understood)*는 규칙이 위 문법에 맞지 않는 것입니다.

태스크 패널은 어디서 태스크를 가져오나요?

아젠다 범위(설정 > 일반 > 태스크)가 덮는 루트의 모든 마크다운 파일에서 가져오고, 기본값은 열려 있는 전체 볼트입니다. 제외할 폴더에 적은 폴더는 건너뜁니다. 쿼리 블록은 다릅니다 — 그것은 늘 그 노트가 있는 볼트를 검색하므로, 한 노트는 모두에게 같은 목록을 보여 줍니다.

왜 제 태스크가 “기한 초과”가 아니라 “예정 밀림”에 있나요?

기한 초과는 놓친 📅 기한입니다 — 스스로 한 약속입니다. 예정 밀림은 놓친 ⏳ 예정일입니다 — 시작하려던 날일 뿐이고 훨씬 약한 신호입니다. 둘을 갈라 두면 날짜 없는 캡처마다 패널이 빨개지는 일이 없습니다.

태스크를 완료하면 날짜가 기록되나요?

네, ✅와 오늘 날짜입니다. 완료일 기록(기본 켬)이 제어합니다. 등록일 기록은 새 태스크 줄을 다 쓰고 나올 때 ➕로 같은 일을 합니다.

태스크에 걸린 시간을 재 줄 수 있나요?

설정 > 일반 > 태스크 > 진행 중인 태스크의 시간 기록을 켜십시오. 태스크가 [/]에 있는 동안 ⏱ 필드를 갖고, 그 상태를 벗어날 때 지난 시간을 누적합니다. 기본을 꺼 둔 것은, 그러지 않으면 태스크를 “진행 중”으로 바꾸는 것만으로 다른 앱도 읽는 파일에 새 필드가 쓰이기 때문입니다.

오래 전에 완료한 태스크는 어떻게 되나요?

요청할 때까지 아무 일도 없습니다. 패널의 완료 항목 정리가 N일(기본 30) 이전에 끝난 것을 tasks/archive/YYYY-MM.md로 옮깁니다. 정리된 태스크도 색인과 검색에 남습니다. 자동으로 정리되는 것은 결코 없습니다.

태스크 패널 말고 어디에 태스크가 나오나요?

두 곳입니다. 백링크 패널에 이 노트의 태스크 구역이 있어, 볼트에서 그 줄이 열어 둔 노트로 링크하는 태스크를 전부 나열합니다. Zettel 허브에는 간결한 태스크 구역이 있습니다 — 기한 초과와 오늘 기한만, 최대 일곱 행, 그리고 전체 보기가 완전한 아젠다를 엽니다. 둘 다 아젠다와 같은 행을 쓰므로 어느 쪽에서든 체크할 수 있습니다.

태스크 행의 −5d와 12d 배지가 무슨 뜻인가요?

−5d는 그 태스크를 그 버킷에 넣은 날짜에서 며칠 지났는지입니다 — 기한 초과에서는 기한, 예정 밀림에서는 예정일. 12d는 묵힘 툴팁과 함께, ➕ 등록일로부터 30일 이상 지나도록 끝나지 않았다는 뜻입니다. 수집함에서 조용히 썩고 있는 것을 드러내려고 있는 표시입니다.

AI가 회의록에서 태스크를 뽑아낼 수 있나요?

네 — 산문을 선택하고 /extract-tasks(할 일 뽑아내기)를 실행하십시오. 제안된 태스크 줄은 여느 AI diff 미리보기를 거치므로, 수락하기 전에는 아무것도 쓰이지 않습니다.

---

쿼리 블록

쿼리 블록이 무엇인가요?

노트 안에 살면서 결과를 그 자리에 렌더하는 저장된 검색입니다. /query로 넣거나 ```query 펜스 코드 블록을 직접 씁니다. 노트나 태스크를 나열할 수 있습니다.

쿼리 결과가 스스로 갱신되나요?

계속 갱신되지는 않습니다. 블록은 빌더를 닫을 때, 쿼리 텍스트가 바뀔 때, Run query를 누를 때, 그리고 그 결과 안에서 태스크를 체크할 때 다시 실행됩니다. 노트 쿼리는 볼트의 모든 마크다운 파일을 읽으므로, 키를 누를 때마다 실행하면 볼트를 끊임없이 훑게 됩니다.

쿼리를 손으로 어떻게 쓰나요?

각 줄은 key: value입니다 — source, filter, sort, display, limit. 모두 선택입니다.

```query
source: tasks
filter: state = "todo" AND due before "+7d"
sort: due asc
display: list
limit: 10
```

필드와 연산자 표 전체는 사용 설명서에 있습니다.

쿼리가 왜 아무것도 안 내나요?

대개는 없는 필드·연산자 조합입니다 — 모르는 조합은 오류를 내지 않고 아무것도 걸지 않으므로 블록이 그냥 비어 보입니다. 빌더를 열어 필드를 다시 고르십시오. 빌더는 동작하는 연산자만 제시합니다. 다른 흔한 원인은 priority입니다 — 쿼리는 입력하는 P1–P5 순위가 아니라 부호 있는 가중치(🔺=2, ⏫=1, 보통=0, 🔽=-1, ⏬=-2)로 거르므로, 우선순위 높은 태스크는 priority > "0"입니다.

쿼리 블록 안에서 태스크를 체크할 수 있나요?

네, 기본값인 display: list에서요. 체크박스가 그 태스크의 파일에 쓰고 블록이 다시 실행됩니다. 콘텐츠 지도를 프로젝트 보드로 쓸 수 있게 하는 것이 그것입니다. 행을 클릭하면 원본 파일의 그 태스크로 이동합니다.

쿼리 블록이 다른 에디터에서 제 파일을 깨뜨리나요?

아니요. 디스크에 저장된 쿼리 블록은 info 문자열이 query인 평범한 펜스 코드 블록이므로, 다른 도구는 그것을 코드 블록으로 보여 줍니다.

---