Obsidian vault 및 마크다운 문서 작업 시 사용. markdown-oxide LSP를 통한 효율적인 검색, 백링크 탐색, 태그 관리 지원. vault 경로, 태그 체계, vault-intelligence CLI, 토큰 최적화 전략 제공. Obsidian, vault, 마크다운, 태그, 노트 정리, zettelkasten, 백링크, wiki-link, PKM 관련 작업 시 자동 적용.
| 항목 | 경로 |
|---|---|
| vault | ~/OneDrive/my-obsidian-vault/ |
| vault-intelligence | ~/git/vault-intelligence/ |
markdown-oxide MCP 서버가 연결되어 있으면 다음 기능을 활용할 수 있다:
[[링크]] → 해당 파일로 이동#태그가 사용된 모든 위치 검색# 백링크 찾기
"TDD 노트를 참조하는 모든 노트 찾아줘"
→ LSP find_references 사용
# 태그 검색
"#project/active 태그가 있는 노트들 찾아줘"
→ LSP find_references 사용
# 깨진 링크 확인
"이 vault에서 깨진 링크가 있는 노트 확인해줘"
→ LSP diagnostics 사용
마크다운 파일 검색 시:
#category/subcategory/detail| 폴더 | 용도 | 작업 권한 |
|---|---|---|
| 000-SLIPBOX | 개인 인사이트 | 읽기/쓰기 |
| 001-INBOX | 수집함 | 읽기/쓰기 |
| 003-RESOURCES | 참고자료 | 주로 읽기 |
| archive | 보관 자료 | 접근 금지 |
vault_root/vault-analysis/improved-hierarchical-tags-guide.md# vis 명령어는 어디서든 사용 가능 (pipx 전역 설치)
vis search "검색어" --search-method hybrid --top-k 10
| 옵션 | 값 | 설명 |
|---|---|---|
--search-method | semantic, keyword, hybrid, colbert | hybrid 권장 |
--rerank | (플래그) | 재순위화로 정확도 향상 |
--expand | (플래그) | 쿼리 확장 (동의어 + HyDE) |
--top-k | 숫자 | 반환 결과 수 |
| ❌ 잘못된 사용 | ✅ 올바른 사용 |
|---|---|
--method | --search-method |
--k | --top-k |
--output-file | --output |
--reranking | --rerank |
vis search --query "TDD" | vis search "TDD" (positional) |
vis collect --topic "TDD" | vis collect "TDD" (positional) |
vis related --file "문서.md" | vis related "문서.md" (positional) |
vis tag --target "문서.md" | vis tag "문서.md" (positional) |
~/git/vault-intelligence/CLAUDE.md/compact 또는 /clear# ❌ 비효율적
"vault의 모든 파일을 분석해줘"
# ✅ 효율적
"003-RESOURCES에서 'kubernetes' 태그가 있는 노트 목록만 보여줘"
| 명령어 | 용도 | 시점 |
|---|---|---|
/compact | 히스토리 압축 | 70% 사용 시 |
/clear | 초기화 | 새 작업 시작 |
/cost | 토큰 확인 | 수시 |
.obsidian/ 폴더archive/ 폴더.canvas 파일.png, .jpg, .gif 등)UNPROCESSED-FILES.md에 기록| 검색 유형 | 권장 도구 |
|---|---|
| 백링크/참조 관계 | markdown-oxide LSP |
| 태그 기반 검색 | markdown-oxide LSP |
| 시맨틱 검색 (의미 기반) | vis |
| 단순 키워드 매칭 | ripgrep |
| 파일명 검색 | glob/find |