TaskNotes 통합 가이드: YAML 프론트매터를 사용한 파일당 하나의 작업
TaskForge가 Obsidian용 TaskNotes 형식을 어떻게 지원하는지 알아보세요. YAML 프론트매터를 사용하여 파일당 하나의 작업으로 관리할 수 있습니다. 상세한 작업 문서화, 풍부한 메타데이터, 구조화된 노트 작성 워크플로우에 완벽합니다.
TaskNotes 형식이란?
TaskNotes는 메타데이터를 위해 YAML 프론트매터를 사용하여 파일당 하나의 작업을 저장하는 작업 관리 형식입니다. 노트 전체에 흩어져 있는 인라인 작업과 달리, TaskNotes는 각 작업에 구조화된 속성과 상세한 문서화를 위한 충분한 공간이 있는 전용 파일을 제공합니다.
파일당 하나의 작업
각 작업은 자체 마크다운 파일에 저장되어 노트, 첨부 파일, 문서화를 위한 무제한 공간을 제공합니다.
YAML 프론트매터
상태, 우선순위, 날짜, 태그 및 사용자 정의 속성을 위한 구조화된 YAML 프론트매터에 작업 메타데이터를 저장합니다.
유연한 식별
태그 또는 사용자 정의 속성으로 TaskNotes를 식별합니다. 워크플로우에 가장 적합한 방법을 선택하세요.
구성 가능한 폴더
새 TaskNotes를 위한 기본 폴더를 설정하고 볼트 구조에 맞게 구성하세요.
TaskNotes 파일 예시
Obsidian 볼트에서 일반적인 TaskNotes 파일은 다음과 같습니다:
---
status: in-progress
priority: high
due: 2025-10-15
tags:
- work
- project-alpha
created: 2025-10-01
---
# Review PR #123
Review the new authentication system PR and provide feedback on:
- [ ] Code quality and patterns
- [ ] Test coverage
- [ ] Documentation completeness
- [ ] Security considerations
## Notes
- Need to verify the new token refresh logic
- Check that rate limiting is properly implemented
- Test with various user permission levels
## Links
- [[Authentication Design Doc]]
- [[Security Guidelines]] 지원되는 속성
상태
작업 완료 상태: 할 일, 진행 중, 보류 중, 계획됨 또는 완료
status: in-progress 우선순위
작업 중요도: 최우선, 높음, 보통, 낮음 또는 최하
priority: high 날짜
마감일, 예약된 날짜, 시작 날짜 및 완료 날짜
due: 2025-10-15 scheduled: 2025-10-10 start: 2025-10-01 태그
목록 형식으로 여러 태그를 사용하여 작업을 구성합니다
tags: - work - urgent - project-alpha
반복
유연한 간격으로 반복 작업을 설정합니다
recurrence: every week TaskNotes 구성하기
- 1
Enable 작업 파일
Open 설정 > 작업 유형, toggle '작업 파일' on, then tap '작업 파일 설정' to configure identification, default folder, and field mapping.
- 2
식별 방법 선택
TaskForge가 TaskNotes 파일을 식별하는 방법을 선택합니다: 특정 태그(예: #task) 또는 사용자 정의 속성(예: type: task)으로 식별합니다.
- 3
기본 폴더 설정
새 TaskNotes가 생성될 기본 폴더를 선택합니다. 이렇게 하면 볼트를 체계적으로 유지할 수 있습니다.
- 4
기본 형식 선택
새 작업을 기본적으로 TaskNotes로 생성할지 인라인 작업으로 생성할지 결정합니다. 사용자 정의 목록별로 언제든지 재정의할 수 있습니다.
- 5
필드 매핑 사용자 정의(선택 사항)
고급: 볼트에서 다른 필드 이름을 사용하는 경우 YAML 속성 이름을 사용자 정의합니다.
TaskNotes vs. 인라인 작업
다음과 같은 경우 TaskNotes 사용:
- 상세한 작업 문서화가 필요한 경우
- 작업에 여러 노트와 첨부 파일이 필요한 경우
- 구조화된 메타데이터를 선호하는 경우
- 작업이 복잡한 프로젝트인 경우
- 검색 가능한 작업 아카이브를 원하는 경우
다음과 같은 경우 인라인 작업 사용:
- 작업이 간단한 실행 항목인 경우
- 작업이 회의 노트에 속하는 경우
- 맥락에 포함된 작업을 선호하는 경우
- 빠른 캡처가 우선순위인 경우
- Obsidian Tasks 플러그인을 사용하는 경우
좋은 소식: 선택할 필요가 없습니다! TaskForge는 두 형식을 나란히 지원합니다. 대형 프로젝트에는 TaskNotes를 사용하고 빠른 실행 항목에는 인라인 작업을 사용하세요. 모두 하나의 통합된 작업 목록에서 관리됩니다.
어떤 고급 TaskNotes 기능을 사용할 수 있나요?
파일당 하나의 작업 관리 기본 기능 외에도 TaskNotes는 시스템을 정확한 워크플로우에 맞게 조정할 수 있는 여러 고급 기능을 제공합니다. 이러한 옵션은 이미 확립된 vault 구조나 노트 정리에 대한 특정 규칙이 있는 경우 특히 유용합니다.
사용자 정의 필드 매핑
vault에서 이미 다른 YAML 속성 이름을 사용하고 있다면 변경할 필요가 없습니다. TaskForge는 기본 필드 이름을 사용자의 것에 맞게 재매핑할 수 있습니다. 예를 들어 'status' 대신 'state'를, 'priority' 대신 'importance'를 사용한다면 TaskForge가 해당 필드를 직접 읽고 쓰도록 구성할 수 있습니다. 기존 파일을 하나도 재구성하지 않고 TaskNotes를 도입할 수 있습니다.
사용자 정의 파일명 형식
{title}, {date}, {priority}와 같은 변수를 사용하여 새 TaskNotes 파일의 이름 지정 방식을 정확하게 제어하세요. 예를 들어 형식을 '{date}-{title}'로 설정하면 모든 작업 파일이 생성 날짜로 시작하여 Obsidian의 파일 탐색기에서 시간순으로 정렬하기 쉬워집니다.
본문 템플릿
모든 새 TaskNotes 파일에 삽입되는 기본 markdown 본문 템플릿을 정의하세요. 작업 파일에 항상 노트 섹션, 체크리스트 섹션, 링크 섹션이 필요하다면 템플릿을 한 번 설정하면 모든 새 작업이 해당 구조로 시작됩니다. 템플릿은 같은 상용구 콘텐츠를 반복 입력하는 수고를 덜어줍니다.
프로젝트와 컨텍스트
TaskNotes는 +ProjectName과 @context 구문을 사용한 프로젝트 및 컨텍스트 주석을 지원합니다. 작업에 +WebsiteRedesign을 태그하여 특정 프로젝트에 연결하거나 @office로 작업 장소를 표시하세요. 이러한 주석은 일반 태그와 함께 작동하여 vault 전체에서 작업을 분류하고 필터링하는 더 풍부한 방법을 제공합니다.
인라인 작업에서 TaskNotes로 어떻게 마이그레이션하나요?
인라인 작업을 사용해 왔고 TaskNotes를 활용하고 싶다면, 좋은 소식은 한 번에 모든 것을 전환할 필요가 없다는 것입니다. TaskForge는 두 형식을 동시에 지원하므로 자신의 속도에 맞춰 점진적으로 마이그레이션할 수 있습니다.
복잡한 작업부터 시작하세요
마이그레이션에 가장 적합한 후보는 한 줄을 넘어선 작업입니다. 인라인 작업에 긴 설명, 여러 하위 작업 또는 참조 링크를 추가하고 있다면, 해당 작업은 자체 파일과 문서화를 위한 무제한 공간을 얻을 수 있는 TaskNotes 형식의 자연스러운 후보입니다.
간단한 작업은 인라인으로 유지하세요
모든 작업에 자체 파일이 필요한 것은 아닙니다. '장 보기'나 '사라 이메일에 답장하기'와 같은 빠른 실행 항목은 인라인 작업으로 완벽하게 작동합니다. TaskNotes 형식은 구조화된 메타데이터와 상세한 노트가 진정으로 도움이 되는 작업을 위해 남겨두세요.
두 형식을 동시에 사용하세요
TaskForge는 인라인 작업과 TaskNotes를 같은 통합 작업 목록에 함께 표시합니다. 형식 혼합에 대해 걱정할 필요가 없습니다. 두 유형 모두 사용자 정의 목록, 캘린더 보기, 위젯에 나타납니다. 앱이 백그라운드에서 차이를 처리하므로 작업에 집중할 수 있습니다.
TaskNotes를 전용 폴더에 정리하세요
vault에 TaskNotes 파일을 위한 전용 폴더를 만드세요. 'Tasks' 또는 'TaskNotes'와 같이 말입니다. 이렇게 하면 vault가 깔끔하게 유지되고 Obsidian의 파일 탐색기에서 작업 파일을 쉽게 찾을 수 있습니다. TaskForge 설정에서 이 폴더를 기본 위치로 설정하면 모든 새 TaskNotes 파일이 자동으로 올바른 위치에 저장됩니다.
배치로 마이그레이션하세요
모든 인라인 작업을 한 번에 변환하는 대신 먼저 마이그레이션할 프로젝트나 생활 영역을 하나 선택하세요. 일주일 동안 업무 작업을 TaskNotes로 옮겨보고 어떤 느낌인지 확인하세요. 워크플로우에 익숙해지면 다른 영역으로 확장하세요. 이 점진적 접근 방식을 통해 완전히 전환하기 전에 필드 매핑과 템플릿을 개선할 수 있습니다.
TaskNotes를 사용해 보시겠습니까?
TaskForge를 다운로드하고 Obsidian에서 상세한 작업 관리 워크플로우를 위해 TaskNotes 형식 사용을 시작하세요. 모든 TaskNotes 기능은 기능 페이지 에서 확인하고, 최신 TaskNotes 개선 사항 에서 최신 업데이트를 확인하세요.
Swift, Kotlin, Flutter로 모바일 및 데스크톱 앱을 개발해 온 10년 이상 경력의 소프트웨어 엔지니어. Canada Toronto에 거주하는 인디 개발자이자 TaskForge 제작자. 자세히 알아보기