📝도구

Obsidian CLI 가이드 - 터미널에서 노트 관리하기

Obsidian 1.12+에서 지원하는 CLI로 터미널에서 노트 생성, 검색, 편집을 자동화하는 방법

↗ 원본 링크

#Obsidian#CLI#노트관리#자동화

Obsidian CLI란?

Obsidian CLI는 터미널에서 Obsidian 노트를 조작할 수 있는 명령줄 인터페이스입니다. 스크립팅과 자동화를 통해 노트 작업의 생산성을 극대화할 수 있습니다.

주요 기능

▸

즉시 실행: 노트 생성, 검색, 편집을 단일 명령으로 실행

▸

자동화 & 스크립팅: cron, shell script, CI/CD 파이프라인 통합

▸

TUI 인터페이스: 자동완성과 명령 히스토리 지원

▸

개발자 도구: 플러그인 리로드, 스크린샷, JS 실행 등

설치 방법

1단계: Obsidian 업그레이드

Obsidian Installer 버전 1.12 이상으로 업그레이드하세요.

2단계: CLI 활성화

Settings → General에서 Command line interface를 활성화합니다.

3단계: CLI 등록

화면 안내에 따라 시스템에 등록하고 터미널을 재시작합니다.

macOS:

bash

export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"

Linux (Flatpak):

bash

ln -s "$HOME/.local/share/flatpak/exports/bin/md.obsidian.Obsidian" "$HOME/.local/bin/obsidian"

기본 사용법

bash

# 도움말 보기
obsidian help

# 오늘의 데일리 노트 열기
obsidian daily

# vault 전체에서 검색
obsidian search query="meeting notes"

# 데일리 노트에 할 일 추가
obsidian daily:append content="- [ ] Buy groceries"

실용 예제

노트 관리

bash

# 템플릿으로 새 노트 생성
obsidian create name="Trip to Paris" template=Travel

# 현재 파일 읽기
obsidian read

# 모든 태그와 빈도 보기
obsidian tags counts

개발자 도구

bash

# 개발자 도구 열기
obsidian devtools

# 플러그인 리로드
obsidian plugin:reload id=my-plugin

# JavaScript 실행
obsidian eval code="app.vault.getFiles().length"

자동화 스크립트

bash

#!/bin/bash
# 매일 아침 루틴 자동화

# 데일리 노트 생성
obsidian daily

# 고정 태스크 추가
obsidian daily:append content="## 오늘의 루틴
- [ ] 이메일 확인
- [ ] 스탠드업 미팅"

# 미해결 링크 확인
obsidian unresolved total

활용 팁

▸

TUI 모드: `obsidian` 명령만 입력하면 자동완성이 지원되는 인터랙티브 모드가 실행됩니다

▸

스크립트 통합: cron job과 결합하여 정기적인 노트 작업을 자동화할 수 있습니다

▸

개발 워크플로우: 플러그인 개발 시 리로드와 디버깅을 CLI로 빠르게 처리할 수 있습니다

요구사항

⚠️ Obsidian Installer 버전 1.12 이상 필요

⚠️ 명령 실행 시 Obsidian 앱이 실행 중이어야 함