obsidian은(는) 무엇을 하나요?
로컬 Obsidian 볼트 작업에 사용하세요. Obsidian 볼트는 마크다운 파일과 .obsidian/ 설정이 있는 일반 폴더입니다.
소스
- 앱 설정:
~/Library/Application Support/obsidian/obsidian.json - 기본 볼트 이름:
obsidian - 일반적인 로컬 볼트 경로:
~/obsidian - 공식 CLI:
obsidian - 볼트 명령은 현재 작업 디렉토리에서 볼트를 확인합니다.
~/obsidian에서 실행하세요.
첫 번째 확인
command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:
version 및 vaults 같은 전역 명령은 볼트 외부에서도 작동합니다. 볼트 내용 명령은 ~/obsidian 외부에서 Vault not found.를 출력할 수 있습니다. CLI 탐색에는 obsidian help 대신 obsidian commands를 사용하세요.
obsidian이 CLI가 비활성화되었다고 말하는 경우:
- 사용자에게 설정 -> 일반 -> 고급 -> 명령줄 인터페이스를 활성화하도록 요청하는 것이 좋습니다.
- 이미 앱 설정 형식을 확인했다면
~/Library/Application Support/obsidian/obsidian.json에서"cli": true를 사용합니다. - 앱 수준 CLI 설정을 변경한 후 Obsidian을 다시 시작하세요.
읽기 워크플로
Obsidian 인식 조회에는 공식 CLI를 선호하세요:
cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json
이미 경로를 알고 정확한 바이트가 필요할 때는 직접 파일 시스템 읽기를 사용하세요:
sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"
신선도나 볼트 선택이 중요할 때는 어떤 소스를 사용했는지 보고하세요.
쓰기 워크플로
가장 좁은 쓰기 경로를 선택하세요:
- 새 노트:
obsidian create path="Folder/Note.md" content="...". - 일일 노트에 추가/앞에 추가:
obsidian daily:append content="...". - 간단한 노트 편집: 마크다운 파일에
apply_patch를 사용하세요. - 노트 이름 바꾸기/이동: 링크가 업데이트될 수 있도록
obsidian move path="Old.md" to="Folder/New.md"를 선호하세요. - 쓰기 후 UI 열기: 유용하거나 요청된 경우에만
open을 추가하세요.
일반적인 명령:
cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Follow-up item"
여러 줄 내용의 경우, 경로를 알게 되면 apply_patch로 .md 파일을 편집하는 것이 좋습니다. 긴 산문에는 취약한 셸 인용을 피하세요.
베이스, 캔버스, 플러그인
먼저 CLI 탐색을 사용하세요:
cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:
.canvas, .base, .json 파일은 가능하면 구조화된 데이터로 읽고 편집하세요. 편집 후 형식을 안정적으로 유지하고 JSON을 검증하세요.
안전
- 볼트를 일괄로 다시 작성하지 마세요. 대상 경로를 사용하고 차이점을 검토하세요.
- 사용자가 요청하거나 작업이 명시적으로 설정/플러그인 작업이 아닌 한
.obsidian/을 편집하지 마세요. - 명시적으로 요청하지 않는 한 노트를 삭제하지 마세요. 영구 삭제보다는 휴지통을 선호하세요.
- Obsidian URI/CLI 경로를 통해 숨겨진 점폴더 노트를 만들지 마세요.
- 작업이 프론트매터나 위키링크를 리팩터링하는 작업이 아니라면 프론트매터와 위키링크를 유지하세요.
- 여러 볼트가 존재하는 경우 추측하지 말고
obsidian vaults와obsidian.json을 사용하세요.