AI 시대의 지식 기반으로서의 Obsidian 입문

서론: 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 시대의 지식 기반으로 선택되는지 납득할 수 있을 것이다.