서론: Obsidian이란 도대체 무엇인가?
Obsidian을 번역하면 "흑요석"입니다. 화산에서 분출된 용암이 급격히 식으면서 만들어지는 천연 유리로, 석기 시대에는 칼이나 화살촉으로 사용되었던 소재입니다. 단단하고, 검으며, 깨뜨리면 날카롭습니다.
왜 메모 앱의 이름이 이것인지 — 사상을 한마디로 말하자면:
Slack나 Twitter처럼
정보가 흘러가는 것이 아니라,
흑요석처럼 시간을 들여 굳어져서, 오래도록 남는 지식(Knowledge)을 만든다.
💭 떠오른 생각 → ✍️ 메모 → 🔗 링크로 연결 → ⏳ 시간 → 💎 지식의 결정체
실체는 로컬 Markdown 파일입니다.
노트를 [[링크]]로 연결해 나가면, 다음과 같은 네트워크가 성장합니다:
독일의 Zettelkasten(제텔카스텐 = 카드형 노트법)의 계보에 있는 도구로, 사상은 **"작은 메모를 대량으로 작성하여, 링크로 그물망을 만든다"**는 한 문장으로 요약됩니다.
사상적 토대: Andrej Karpathy 「LLM Wiki」(2026-04-04)
본 자료는 Andrej Karpathy가 제창한 LLM Wiki라는 설계 패턴을, 업무에서 운용하는 구체적인 구현 가이드로 위치시키고 있다.
Karpathy의 말에 따르면:
"In practice, I have the LLM agent open on one side and Obsidian open on the other. ...Obsidian is the IDE; the LLM is the programmer; the wiki is the codebase."
삼층 관계는 그대로 본 자료의 골격과 일치한다:
- Raw sources (1차 자료) = Web Clipper나 Slack/Drive 등에서 가져오는 원본 데이터
- The wiki (축적되는 Markdown) = Obsidian Vault 본체
- The schema (운용 규칙) = 프론트매터 (Frontmatter) 규약 · 명명 규칙 · obsidian-skills 설정
매번 문서에서 다시 불러오는 기존의 RAG와 달리, LLM이 쓰고, 인간이 Obsidian으로 읽으며, 지식이 자산으로서 축적되어 간다 — 이 발상이 본 자료를 관통하고 있다.
LLM Wiki의 3층 — 도해
Karpathy의 메타포(Metaphor)와의 대응
| LLM Wiki 3층 | Karpathy의 표현 | 역할 |
|---|
| ① Raw sources (수집 원천) | | Web이나 업무 도구에 산재한 1차 정보 |
| ② The wiki | the codebase | 축적되어 링크로 연결되는 지식 본체 |
| ③ The schema | (IDE 설정에 가까움) | 작성 방식 · 배치 규칙 = 품질 보증 |
| 👤 인간 | (사용자) | Obsidian = the IDE 로 읽고 쓰기 |
| 🤖 LLM | the programmer | 스킬을 통해 wiki를 업데이트하는 작성자 |
중요한 것은 schema (운용 규칙)가 LLM의 작성 방식을 제약한다는 점이다. 이것이 없으면 wiki는 난잡해지고, 복리 효과를 기대할 수 없게 된다. 본 자료의 §3 · §5에서 다루는 「프론트매터 규약」 「명명 규칙」 「obsidian-skills」가 여기에 해당한다.
공식 리소스:
1. Obsidian 본체 (Download)
대응 플랫폼
Windows / Mac / Linux / iOS / Android 모두 대응.
라이선스 · 요금
| 항목 | 요금 | 필수 여부 |
|---|
| 본체 (개인 이용) | 무료 · 가입 불필요 | ─ |
| 본체 (상업 이용) | 완전히 무료. 공식 pricing에 You are not required to pay for a commercial license라고 명시됨 | ❌ 불필요 |
| 상업용 라이선스 | $50/사용자/년 | △ 임의 (개발 지원을 위한 기부에 가까움) |
| Obsidian Sync (공식 동기화 서비스) | $4/월 (연결제) 또는 $5/월 (월결제) | △ 임의 (멀티 디바이스 동기화가 필요하다면 검토) |
| Obsidian Publish (공개 웹사이트화) | $8/월 (연결제) 또는 $10/월 (월결제) | △ 임의 |
데이터 저장: 로컬 Vault(폴더)에 Markdown으로 저장 → 벤더 락인 (Vendor Lock-in) 없음 - 위의 유료 서비스는 모두 "추가하고 싶은 사람만 추가하는" 구조입니다.
본체만 사용한다면 법인 이용 시에도 완전 무료입니다.
파악해야 할 특징
- 파일 실체는 플레인 Markdown (Plain Markdown) → Git 관리 및 타 도구 병용이 용이 - 플러그인/테마로 확장 가능
- 모바일 ↔ 데스크톱 간에는 Obsidian Sync (유료) 또는 iCloud/Dropbox 등으로 동기화
2. Obsidian Web Clipper
브라우저 확장 프로그램으로 작동하며, 웹 페이지를 Markdown으로 변환하여 Vault로 직접 저장하는 도구입니다.
주요 브라우저 (Chrome / Safari / Firefox / Edge 등)를 지원합니다.
주요 기능
4가지 핵심 기능
- 페이지 전체 클립: HTML을 Markdown으로 변환하여 오프라인화
- 하이라이트 저장: 텍스트, 이미지, 콘텐츠 블록을 선택하여 저장. 재방문 시 하이라이트 표시
- 템플릿: 기사 / 레시피 / 영화 / 학술 논문 등 콘텐츠 타입별로 자동 분류
- 데이터 추출: 메타 태그, Schema.org, CSS 셀렉터를 사용한 구조화된 데이터 가져오기
개인정보 보호
3. kepano/obsidian-skills
Obsidian 제작자 중 한 명인 kepano가 공개한, Obsidian 조작용 Agent Skills 리포지토리입니다.
Agent Skills란
Anthropic이 제창하는 Agent Skills 사양에 준거한 스킬 집합입니다. Claude Code, Codex CLI 등 대응 에이전트에서 호출할 수 있습니다.
요컨대 "Obsidian의 Vault를 LLM 에이전트로부터 안전하게 편집하기 위한 공통 프로토콜"이라고 이해하면 좋습니다.
제공되는 5가지 스킬
대략적으로 "무엇을 하고 싶은가"에 따라 선택하면 고민할 필요가 없습니다.
| 스킬명 | 이럴 때 사용 | 한 줄 요약 |
|---|
obsidian-markdown | 노트 한 장 한 장의 내용을 정리하거나 작성할 때 | 메인 기능. 서식 통일, 위키 링크 (Wiki-link), 콜아웃 (Callout), 프론트매터 (Frontmatter) |
obsidian-bases | 대량의 노트를 표나 카드로 일람하고 싶을 때 | DB 뷰 생성. 필터링 · 분류 · 집계 |
json-canvas | 구조나 관계성을 도표로 생각하고 싶을 때 | 화이트보드 (.canvas) 생성 · 편집 |
obsidian-cli | 여러 파일을 일괄 처리하고 싶을 때 | 이름 변경 · 이동 · 모든 노트에 프론트매터 일괄 추가 등 |
defuddle | 웹 기사를 깔끔한 Markdown으로 가져오고 싶을 때 | 에이전트로부터 자동 웹 클립 |
설치 방법
# Claude Code Marketplace 경유 (권장)
/plugin marketplace add kepano/obsidian-skills
Web Clipper와의 차이점
4. 조합의 전체상
"정보가 어떻게 들어오고, 어떻게 편집되는가"
화살표는 **정보의 흐름 (누가 어디로 데이터를 보내는가)**을 나타냅니다.
읽는 법:
- 왼쪽에서 오른쪽으로: 웹 페이지 → 가져오기 → Vault (보관소) → 열람
- Vault가 중심입니다.
사람도 AI도, 이 동일한 상자를 공유하며 다루는 것이 포인트입니다.
역할 분담 (3층 모델)
"누가 · 어떤 스킬을 통해 · 무엇을 다루는가"를 3개 층으로 정리합니다.
도표 읽는 법
- 사람은 Obsidian 앱으로
.md를 직접 편집 (최단 경로)
- AI 에이전트는 반드시 obsidian-skills를 경유하여 파일에 접근 → 안전한 역할 분담
- 가져오기 입구는 2개 계통: Web Clipper (사람이 브라우저에서 수동 클립) / defuddle (에이전트가 자율 취득)
- 확장자와 편집 스킬이 1대1로 대응:
.md = markdown.base = bases.canvas = canvas
obsidian-cli는 확장자에 상관없이 횡단적으로 일괄 처리 (이름 변경 · 프론트매터 추가 등)- 데이터 층은 모두 플레인 파일 → Git으로 버전 관리 및 타 도구 이관도 간편
5. 실무에서의 활용 사례
케이스 ①: 조사한 웹 페이지를 저장하기 (리서치 업무)
Biz 활용 예시: 경쟁사 조사, 업계 리포트, 시장 리서치의 1차 자료를 한곳에 집약 → 나중에 AI에게 횡단적(cross-cutting)으로 요약하게 함.
케이스 ②: 잡다하게 모아둔 메모를 재구성하고 싶을 때
"sources 폴더에 메모를 적당히 던져 넣었는데, 전체상이 보이지 않는다"라는 상황.
다음 순서로 진행하면 원활함:
- 전체 구성을 결정 — 폴더 계층, 명명 규칙, 필수 프런트매터 (Frontmatter) (예:
type, status, tags) 설정
obsidian-markdown을 사용하여 각 노트의 서식 통일 (헤딩 레벨, 콜아웃 (Callout), 링크)obsidian-bases로 목록 뷰(List view) 작성 (태그별, 상태별 등)- 파일 수가 많다면
obsidian-cli로 일괄 처리 (이름 변경, 프런트매터 추가)
6. 조직 공유를 어떻게 할 것인가
Obsidian의 마지막 과제는 "개인의 Vault를 어떻게 팀으로 확장할 것인가"이다.
기본은 3가지 패턴. 비용, 운용 부하, 모바일 대응의 균형에 따라 결정한다.
선택지의 전체상
① 스탠드얼론 (Standalone) 운용 (개인 완결)
- 비용: 무료 (개인 이용)
- 장점: 심플하며 가장 빠르게 시작할 수 있음
- 단점: 타인과 공유할 수 없음
- 용도: 개인의 리서치, 학습 노트, PKM (Personal Knowledge Management)
② 클라우드 공유 (Google Drive / Dropbox / GitHub 등)
Vault 폴더를 클라우드에 업로드하여 Markdown을 동기화하는 패턴. 수단은 다양하지만, 본질은 "Markdown 파일군을 클라우드를 통해 공유하는 것"뿐이므로 동일한 범주로 취급할 수 있다.
- 비용: 기존 계약으로 해결 또는 무료 (GitHub의 개인/Public 리포지토리 등)
- 장점:
- 기존 인프라를 활용할 수 있음
- 폴더/리포지토리 단위의 권한 관리가 가능함
- GitHub를 사용하면 변경 이력 및 PR (Pull Request) 리뷰도 운영 가능 (= 엔지니어 조직에 강력함)
- 단점:
- 동시 편집 시 충돌에 취약함 (같은 노트를 2명이 동시에 편집하면
conflict-copy 등이 발생)
- 모바일 동기화는 다소 번거로움 (GitHub라면 Working Copy 등의 추가 앱 필요)
.obsidian/ 설정 폴더째로 공유하면 개인 설정까지 섞이므로 주의 필요
- 운용 팁:
- 편집 전에 Slack으로 "지금 ◯◯ 건드립니다"라고 한마디 하는 문화
.gitignore를 통해 공유 제외 설정으로 .obsidian/workspace*.json 등의 개인 상태 파일은 제외- GitHub 운용 시
obsidian-git 플러그인으로 자동 push, 기밀 Vault는 Private repo + SSO/2FA 사용
③ Obsidian Sync (공식 유료)
- 비용: 월 $4 (연 결제) 또는 월 $5 (월 결제) (요금 상세는 §「라이선스·요금」 참조)
- 장점: 엔드 투 엔드 암호화 (End-to-end encryption) 적용 - 충돌 해결 및 버전 이력이 공식 지원됨 - 모바일 동기화가 안정적임 - 공유 Vault로 팀 협업 가능
- 단점: 구독 비용 발생 - 팀 규모가 커지면 별도의 설계가 필요함
비교표
| 방식 | 비용 | 동시 편집 | 모바일 | 추천 규모 |
|---|
| ① 스탠드얼론 | 무료 | 불필요 | iCloud 등 | 1인 |
| ... | | | | |
7. 벡터 검색 (RAG)을 나중에 추가하기 — 200개 이상의 파일에 대비
결론
왜 200개 이상의 파일에서 필요해지는가
파일이 늘어나면, Claude에게 직접 읽히는 방식은 3가지 벽에 부딪힌다.
| 과제 | ~100개 파일 | 200개 초과 파일 |
|---|
| 파일 목록 | Glob으로 충분 | 경로 나열만으로 수천 토큰 소비 |
| ... | | |
RAG는 "의미가 유사한 청크 (Chunk)만 몇 개 추출"함으로써, 3가지를 동시에 해결한다.
메커니즘 — 한마디로
구성 2종 세트
| 부품 | 역할 | 채택 이유 |
|---|
| nomic-embed-text | 문장 → 768차원 벡터 (Vector) 변환 | 로컬 동작 · 무료 · 일본어 가능 |
| SQLite + sqlite-vec | 벡터 DB (Vector DB) | 단일 파일, 서버 불필요 |
전체도
규모별 활용 구분
| 파일 수 | 권장 사항 |
|---|
| ~100 | Claude 직접 사용 (Read / Grep) |
| ... | |
한 줄 요약
데이터 실체가 Markdown이기 때문에, "처음에는 Claude를 직접 사용하고, 데이터가 쌓이면 RAG를 추가한다"라는 사후 적용이 가능하다. 이것이 Obsidian을 선택하는 실리 중 하나이다.
마치며: Obsidian이 효과적인 진짜 이유
메모 · 지식 관리 도구는 무수히 많지만, **"데이터 실체가 로컬의 Markdown"**이라는 점이 모든 것을 바꾼다:
- 구독을 중단해도 남는다
- GitHub에서 이력 관리 · PR 리뷰 · CI까지 돌릴 수 있다
- AI 에이전트가 직접 읽고 쓸 수 있다
- 나중에 RAG를 추가할 수 있다
- 다른 도구로 이행할 수 있다
벤더의 편의에 휘둘리지 않는 지식 인프라를 개인 수준에서부터 구축하고, 시간을 들여 키워나간다. 그것이 Obsidian(흑요석)이라는 이름에 담긴 사상입니다.
Obsidian is the IDE; the LLM is the programmer; the wiki is the codebase.
— Andrej Karpathy 「LLM Wiki」에서
매번 1차 자료를 다시 불러오는 RAG가 아니라, LLM이 쓰고, 인간이 Obsidian으로 읽으며, 지식이 자산으로서 복리로 쌓이는 — 본 자료가 그린 것은 그 사상의 업무용 구현 가이드이다.
참고 링크
사상적 토대
- Karpathy: LLM Wiki (Gist, 2026-04-04) — "Obsidian is the IDE; the LLM is the programmer; the wiki is the codebase." 본 자료의 3층 모델(1차 자료 / Vault / 스키마)은 이 Gist를 준거로 한다. 가장 먼저 읽어본다면, 왜 Obsidian이 AI 시대의 지식 기반으로 선택되는지 납득할 수 있을 것이다.