---
title: Obsidian CLI 참조
updated: 2026-04-14
---

# Obsidian CLI 참조

이 프로젝트 볼트는 Obsidian 공식 CLI(1.12.4+)로 검색 가능. 파일시스템 grep보다 빠르고 Obsidian 인덱스·wikilink·백링크를 활용한다.

## 문법
`obsidian <command> key=value key=value` (Unix 플래그 아님)
값에 공백이 있으면 따옴표: `query="증분 파라메트릭"`

## 주요 명령
- `obsidian search query="<질의>" path=wiki` — 파일명 목록 반환
- `obsidian search:context query="<질의>" path=wiki` — 매칭 라인 컨텍스트 포함
- `obsidian read file="<페이지명>"` — 파일 내용 읽기 (wikilink 이름으로 해결)
- `obsidian backlinks file="<페이지명>"` — 백링크 조회
- `obsidian outline file="<페이지명>"` — 헤딩 목록
- `obsidian files folder=wiki` — 폴더 파일 목록
- `obsidian open file="<페이지명>"` — 앱에서 페이지 열기
- `obsidian help` / `obsidian help <command>` — 도움말

## 사용 원칙
- `wiki/` 검색 시 `obsidian search:context` 우선 (Obsidian 앱 실행 필수). 미실행·미설치 시 Grep 폴백.
- 파일 읽기는 경로 대신 이름(`file=...`) 사용 가능 — Read 도구보다 wikilink 친화적.
- 복잡한 질의·개념 QA는 `query` skill이 상위 레이어 (index.md → 필요 시 CLI 보조).