Kanban 원문 문법
가장 작은 보드
# 첫 프로젝트 보드
## 할 일
- [ ] 소개 페이지 초안
## 진행 중
- [ ] 기능 화면 캡처
## 완료
- [x] 프로젝트 폴더 만들기H2는 컬럼이다
Kanban은 H2 section을 컬럼으로 읽는다. H2 아래의 내용은 다음 H2가 나오기 전까지 같은 컬럼에 속한다.
## 할 일컬럼 순서를 바꾸는 source-backed 명령은 H2 section 전체를 옮긴다. 화면에서만 순서를 덮어쓰는 별도 보드 상태를 만들지 않는다.
list item과 task는 편집 가능한 카드다
가장 간단한 카드는 top-level list item이다.
- 소개 페이지 초안
- 인터뷰 메모 정리task marker를 사용하면 완료 여부를 Markdown 자체에 남길 수 있다.
- [ ] 아직 끝나지 않은 카드
- [x] 완료한 카드H3 heading과 이어지는 문단도 best-effort Kanban에서 카드처럼 읽을 수 있다. 다만 이 문서는 sourceEditable: false인 읽기 경계다. 추가·이동·삭제까지 필요한 보드는 top-level list 또는 task로 정리한다. H3 카드 예제로 두 모드의 차이를 확인할 수 있다.
WIP limit
H2 제목 끝에 [wip:N]을 붙이면 컬럼의 WIP limit으로 읽는다.
## 진행 중 [wip:2]표시 제목에서는 suffix가 숨겨지고, 카드 수가 limit을 넘으면 초과 상태를 보여 준다. WIP는 카드 이동을 자동 거절하는 숨은 데이터가 아니라 Markdown에 적힌 작업 신호다.
카드 metadata
카드 제목 끝의 연속 suffix는 badge로 읽힌다.
- [ ] 소개 페이지 초안 [owner:준] [priority:P1] [label:문서]| suffix | 의미 | 예 |
|---|---|---|
owner |
담당자 | [owner:준] |
priority |
P0~P3 우선순위 |
[priority:P1] |
due |
실제 calendar date인 마감일 | [due:2026-07-31] |
stale |
명시적 stale 기준일 | [stale:2026-08-10] |
label |
분류 badge | [label:문서] |
본문이나 제목 중간의 대괄호는 일반 Markdown 텍스트다. suffix는 카드 제목 끝에 연속해서 있을 때만 metadata로 해석한다.
원문 화면
