readme

🗂 Obsidian Zettelkasten Boilerplate

**개인 지식 관리 시스템(PKM)**을 위해 설계된 Obsidian Vault 템플릿입니다.
Zettelkasten 방법론을 기반으로, 다양한 지식을 체계적으로 기록·연결·배포할 수 있습니다.

---

📑 목차

• 프로젝트 개요
• 디렉토리 구조
• 지원 시스템
• 기술적 특징
• 워크플로우
• 장점
• 웹사이트 배포
• 기여

---

📌 프로젝트 개요

이 저장소는 Obsidian에서 사용할 수 있는 Zettelkasten 기반 지식 관리 구조를 제공합니다.
외부 자료 → 재작성 → 연결 → 정제 → 태그화의 과정으로 지식을 축적하며,
Git과 Python 스크립트를 통한 자동화·버전관리를 지원합니다.

---

📂 디렉토리 구조

1. 📚 참고 노트 (Reference Notes)

• 외부 자료 원문 저장
• 예: ai 답변/, 책/강의 요약 등

2. ✍️ 문헌 노트 (Literature Notes)

• 참고 노트를 자신의 언어로 재작성·요약
• 예: 데일리노트/, 주간노트/

3. 🏷️ 태그 (Tags)

• 주제별 분류 및 허브 역할
• 관련 노트를 자동 목록화

4. 📋 색인 (Index)

• 태그들 간 관계 시각화·탐색 지원

5. 💎 영구 노트 (Permanent Notes)

• 정제된 핵심 개념 저장
• 지식 네트워크 중심 노드 역할

---

🛠 지원 시스템

_templates (템플릿)

• Main Note.md : 일반 노트 기본 템플릿
• AI Res.md : AI 답변용
• Tags.md : 태그 노트
• Index.md : 색인 노트
• daily.md : 일일 노트
• weekly.md : 주간 노트

python (자동화 스크립트)

• ai답변 publish.py : AI 노트 발행 상태 관리
• 태그 publish.py : 태그 노트 발행 상태 관리
• 영구노트 자동.py : 문헌→영구 노트 이동 자동화
• 영구노트 publish.py : 영구 노트 발행 상태 관리

assets

• 이미지·PDF·다이어그램 저장

---

⚙ 기술적 특징

사용 플러그인

• Core: 파일 탐색기, 검색, 그래프 뷰, 백링크 등
• Community:
  calendar, dataview, git, periodic-notes,
  templater, quartz-syncer, minimal-theme 등

자동화

• Templater: 제목·메타데이터·링크 자동 삽입
• Dataview: 노트 목록 자동 생성
• Python: 대량 메타데이터 처리

메타데이터

• publish, 태그, 상태, 참조

---

🔄 워크플로우

1. 새로운 학습 자료 처리

   • 강의/책/영상 내용 → 1-📚 참고 노트에 저장
   • 이해한 내용 → 2-✍️ 문헌 노트에 재작성
   • 완전히 소화된 개념 → 5-💎 영구 노트로 승격

2. 지식 탐색하기

   • 주제별로 찾기 → 3-🏷️ 태그 활용
   • 연관 개념 찾기 → 백링크와 나가는 링크 활용
   • 전체 구조 파악 → 그래프 뷰 활용

3. 정기 정리 작업

   • 2-✍️ 문헌 노트/임시/ 폴더 정리
   • 영구 노트 승격 후보 확인
   • 끊어진 링크 및 중복 노트 정리

템플릿 활용

• 새 노트 생성시 자동으로 Templater가 실행되어 메타데이터와 연결 설정
• 각 노트 유형별 템플릿이 _templates/ 폴더에 준비됨

자동화 도구

• _codes/ 폴더의 Python 스크립트들로 메타데이터 일괄 관리
• Dataview 플러그인으로 동적 목록 생성
• Git 연동으로 자동 버전 관리

학습 자료 처리

1. 수집 → 1-📚 참고 노트
2. 소화 → 2-✍️ 문헌 노트
3. 연결 → 링크 생성
4. 정제 → 5-💎 영구 노트
5. 분류 → 3-🏷️ 태그

지식 탐색

1. 태그 기반 탐색
2. 링크 추적
3. 그래프 뷰
4. 검색 활용

---

🌟 장점

• 연결성: 모든 노트가 링크로 연결
• 확장성: 대량 노트도 체계 관리 가능
• 자동화: 반복 작업 최소화
• 버전 관리: Git으로 이력 추적·백업

---

🌐 웹사이트 배포

이 템플릿은 Quartz를 사용해 웹사이트로 배포할 수 있습니다.

---

🤝 기여

Pull Request·이슈 제안 모두 환영합니다.