[285] 옵시디언 Python 스크립트 소개

옵시디언(Obsidian)에서 Python 스크립트를 활용하여 Daily Notes Index와 Full Vault Index 파일을 자동 생성하는 방법을 설명하겠습니다. 이 스크립트는 옵시디언의 마크다운 파일을 기반으로 인덱스를 생성하며, 자동화를 통해 효율적인 노트 관리가 가능합니다.

1. Daily Notes Index Generator 설치 및 사용법

기능

• Daily Notes 폴더에 있는 모든 파일의 목록을 생성합니다.
• 간단한 출력 형식으로 인덱스 파일을 만듭니다.

설치 방법

1. Python3 설치
   • Python이 설치되어 있지 않다면Python 공식 웹사이트에서 다운로드하여 설치합니다.
2. 스크립트 다운로드
   • GitHub Gist에서create-notes-index.py스크립트를 다운로드합니다.
3. 스크립트 수정
   • 스크립트 내 상수 값을 본인의 환경에 맞게 수정합니다.

     DAILY_NOTES_DIR:str="/Users/user/Projects/scratch/notes/Notes/DailyNotes/"# Daily Notes 폴더 경로NOTES_DIR:str="/Users/michael/Projects/scratch/notes/Notes/"# Vault 루트 디렉토리INDEX_NAME:str="Index Daily Journal.md"# 생성될 인덱스 파일 이름DATE_FORMAT_REGEX:str=r"^\d{4}-\d{2}-\d{2}"# 날짜 형식 (기본: YYYY-MM-DD)PRINT_WARNING:bool=True# Warning.md 파일 출력 여부
4. 스크립트 실행
   • 터미널(명령 프롬프트)에서 아래 명령어를 실행합니다:

     python create-notes-index.py
   • 자동화를 위해cron,Automator.app등을 사용하여 정기적으로 실행되도록 설정할 수 있습니다.

출력 예시

• Daily Notes 폴더에 있는 모든 파일의 이름이 링크 형태로 나열된 마크다운 파일이 생성됩니다.

2. Full Vault Index Generator 설치 및 사용법

기능

• Vault 내 모든 마크다운(.md) 파일의 전체 인덱스를 생성합니다.
• 폴더별로 그룹화하며, 각 파일의 H1, H2 헤더를 추출하여 링크를 생성합니다.

설치 방법

1. 스크립트 다운로드
   • GitHub Gist에서create-notes-index-full.py스크립트를 다운로드합니다.
2. 스크립트 수정
   • 아래 상수를 본인의 Vault 경로에 맞게 수정합니다:

     VAULT_PATH:str='/Users/user/Projects/notes/Notes/'# Vault 루트 디렉토리 경로

     INDEX_FILE_NAME: LiteralString ='Index.md'# 생성될 인덱스 파일 이름

     FILE_EXTENSION: LiteralString ='.md'# 처리할 파일 확장자LOG_LEVEL: LiteralString ='INFO'# 로그 레벨 (DEBUG, INFO, WARNING, ERROR)PRINT_WARNING:bool=True# Warning.md 출력 여부
3. 스크립트 실행
   • 터미널에서 아래 명령어를 실행합니다:

     python create-notes-index-full.py
4. 자동화 설정
   • 위와 동일하게cron,Automator.app등을 활용해 정기 실행 설정이 가능합니다.

출력 예시

• Vault 내 모든 폴더와 파일이 계층적으로 정리된 마크다운 인덱스가 생성됩니다.
• 각 파일의 H1, H2 헤더가 링크 형태로 포함됩니다.

3. 자동화 설정 (Mac 기준 예시)

• Mac 사용자는 Automator 또는launchd를 활용해 스크립트를 자동 실행할 수 있습니다.
  1. Automator에서 새로운 워크플로우를 생성합니다.
  2. "Run Shell Script" 작업을 추가하고 아래 명령어를 입력합니다:

     python3 /path/to/create-notes-index.py
  3. 저장 후 시간 기반으로 실행되도록 설정합니다.

4. 주의사항 및 팁

• 스크립트를 실행하기 전에 Vault 데이터를 백업하세요.
• 스크립트 수정 시 경로나 파일 이름에 오타가 없는지 확인하세요.
• Python 라이브러리 충돌 방지를 위해 가상 환경(Virtual Environment)을 사용하는 것이 좋습니다.

위 방법으로 옵시디언 Vault를 체계적으로 관리하고, Daily Notes 및 전체 Vault의 인덱스를 손쉽게 생성할 수 있습니다!