Obsidian 핸드북 on RanceLee的博客

Claudian: Obsidian 사이드바에 Claude Code 넣기

Mon, 01 Jan 0001 00:00:00 +0000

Obsidian에 AI를 통합하는 방법은 크게 세 가지가 있습니다: 파일 경로 직접 제공, Obsidian CLI 사용, Skills 사용. 이 중 CLI와 Skills의 조합이 가장 좋은 결과를 내지만, 진입 장벽도 가장 높습니다. 터미널을 열어야 하고, CLI 명령어를 알아야 하며, Skills를 직접 작성하거나 수정해야 하기 때문입니다.

이 모든 과정이 번거롭게 느껴지거나, 가끔씩만 AI가 노트 정리를 도와주길 원한다면, 오늘 소개할 플러그인이 더 가벼운 대안이 될 수 있습니다: Claudian.

플러그인 방식과 터미널 직접 사용의 차이

Claudian을 이야기하기 전에, 이 두 접근 방식의 근본적인 차이를 짚고 넘어가겠습니다.

터미널을 직접 사용할 때는 Obsidian과 Claude Code라는 두 개의 창이 있습니다. Obsidian에서 노트를 작성하다가 AI의 도움을 받고 싶으면 터미널로 전환해서 “이 파일 한번 봐줘: /Users/you/Obsidian/SomeNote.md“라고 말합니다. AI가 처리한 후에는 다시 Obsidian으로 돌아와 결과를 확인합니다. 두 창을 왔다 갔다 해야 하고, 매번 어떤 파일을 작업 중인지 직접 지정해야 합니다.

플러그인 방식은 다릅니다. Claudian은 AI를 Obsidian의 사이드바에 내장합니다. 어떤 노트를 열든 AI가 자동으로 현재 보고 있는 내용을 인식합니다. 파일 경로를 지정할 필요 없이 오른쪽 패널에서 대화만 하면 됩니다. 작업이 끝나면 창을 전환할 필요 없이 결과가 노트에 바로 반영됩니다.

비유하자면, 터미널 방식은 옆방에 비서가 있는 것과 같습니다. “이 문서 좀 처리해줘"라고 말하려면 직접 가서 파일을 가져와야 합니다. 플러그인 방식은 책상 바로 옆에 비서가 앉아 있는 것과 같습니다. “이 문단 좀 고쳐줘"라고 말하면 바로 앞에서 작업해 줍니다.

한 가지 분명히 해둘 점은: Claudian은 본질적으로 여전히 Claude Code CLI를 호출합니다. 기능 자체는 터미널에서 Claude Code를 직접 사용하는 것과 동일하며, 다른 AI를 사용하는 것이 아닙니다. 유일한 차이는 진입점이 터미널에서 Obsidian 사이드바로 옮겨졌다는 점입니다.

따라서 이미 Skill + CLI 방식을 본격적으로 사용하고 있다면, Claudian이 더 강력한 대체재는 아닙니다. 단지 조작을 더 매끄럽게 만들어 줄 뿐입니다. 터미널을 자주 사용하지 않거나, 그 설정이 너무 무겁게 느껴진다면 Claudian이 더 적합한 진입점이 될 수 있습니다.

Claudian이란?

Claudian은 YishenTu가 만든 Obsidian 플러그인입니다. MIT 라이선스로 오픈소스입니다. GitHub 저장소:

https://github.com/YishenTu/claudian

2026년 초에 출시되어 빠르게 4,500개 이상의 별을 받았고, Obsidian과 Claude 사용자들 사이에서 빠르게 퍼졌습니다.

현재는 아직 공식 Obsidian 플러그인 마켓플레이스에 등록되지 않았으므로, 수동 설치가 필요합니다.

설치 방법

설치 전에 다음 두 가지를 확인하세요:

Claude Code CLI가 설치되어 있어야 합니다 (명령줄 버전, 웹 버전 아님)
Obsidian 버전이 1.8.9 이상이어야 합니다

이것들은 필수 조건이며, 둘 다 필요합니다. Claude Code 설치는 공식 문서를 참조하세요: claude.com/code.

이 플러그인은 다양한 모델을 지원합니다: Claude 구독, API Key, 또는 OpenRouter나 DeepSeek처럼 Anthropic API 형식을 지원하는 플랫폼.

설치 방법 1: GitHub Release에서 수동 다운로드 (권장)

https://github.com/YishenTu/claudian/releases 로 이동하여 최신 릴리스 페이지를 엽니다
main.js, manifest.json, styles.css 세 파일을 다운로드합니다
Vault에서 .obsidian/plugins/ 폴더를 찾아 claudian이라는 새 폴더를 만듭니다
세 파일을 그 폴더에 넣습니다
Obsidian → 설정 → 서드파티 플러그인 → Claudian을 찾아 활성화합니다

설치 방법 2: BRAT 플러그인으로 자동 설치

BRAT은 아직 공식 마켓플레이스에 없는 플러그인을 설치하기 위한 도구입니다. 설치 후 BRAT이 Claudian의 업데이트를 자동으로 알려줍니다.

Obsidian 커뮤니티 플러그인에서 BRAT을 검색하여 설치하고 활성화합니다
BRAT 설정을 열고 “Add Beta plugin"을 클릭합니다
https://github.com/YishenTu/claudian을 입력하고 Add Plugin을 클릭합니다
설치 후 커뮤니티 플러그인에서 Claudian을 활성화합니다

두 방법 모두 작동합니다. 수동 다운로드가 더 간단하고, BRAT은 업데이트를 더 쉽게 해줍니다.

Claudian으로 할 수 있는 것

사이드바 채팅, Vault에 직접 작업

왼쪽 리본에서 로봇 아이콘을 클릭하거나 명령 팔레트를 사용하여 Claudian 패널을 엽니다. 오른쪽에 채팅 패널이 나타납니다.

여기서 AI와 대화하면 AI가 Vault에서 직접 작업을 수행할 수 있습니다: 파일 읽기, 파일 쓰기, 내용 검색, 명령 실행 등 터미널에서 Claude Code를 사용할 때와 동일한 기능입니다. 유일한 차이는 Obsidian 인터페이스를 벗어나지 않는다는 점입니다.

현재 노트 자동 인식

이 기능이 가장 편리하다고 생각합니다.

어떤 노트를 열든 Claudian이 자동으로 그 노트를 컨텍스트에 첨부합니다. AI가 현재 보고 있는 내용을 알기 때문에 매번 파일 경로를 지정할 필요가 없습니다.

다른 파일을 참조하고 싶다면 채팅 상자에 @를 입력하세요. 드롭다운 목록이 나타나 Vault 파일을 선택하거나 MCP 서비스나 커스텀 Agent를 참조할 수 있습니다.

또한 특정 노트에 태그(예: private)를 지정하면 Claudian이 해당 파일을 자동으로 건너뛰어 내용을 AI에 보내지 않습니다.

인라인 편집: 텍스트 선택 후 바로 수정

전체 노트를 AI가 수정하지 않고 특정 문단만 편집하고 싶을 때 유용한 기능입니다.

수정할 텍스트를 선택하고 단축키(사용자 지정 가능)를 누르면 작은 패널이 나타납니다. “이 문장을 더 대화체로 바꿔줘” 또는 “이걸 영어로 번역해줘” 같은 지시를 내리면 AI가 선택한 부분만 처리합니다.

이미지 지원

채팅에서 이미지를 보낼 수 있습니다: 드래그 앤 드롭, 스크린샷 붙여넣기, 이미지 파일 경로 입력 등 세 가지 방법 모두 가능합니다.

이미지를 본 AI는 내용을 설명하거나, 텍스트를 추출하거나, “이 이미지가 무엇에 관한 것인지” 같은 질문에 답할 수 있습니다. 스크린샷을 자주 노트에 활용하는 사람에게 매우 유용합니다.

슬래시 명령어

/를 입력하면 미리 정의된 명령 템플릿 목록이 나타납니다.

예를 들어 “현재 노트의 핵심 요약"이라는 작업을 자주 사용한다면 /summarize로 저장해 둘 수 있습니다. 다음에는 /summarize만 입력하면 명령이 확장되어 매번 다시 입력할 필요가 없습니다.

템플릿에는 매개변수 자리표시자, @files 참조, 심지어 bash 명령어도 포함할 수 있습니다. Claude Code Skills를 사용한다면 Claudian이 동일한 형식을 인식하므로 둘 사이에 공유할 수 있습니다.

계획 모드

Shift+Tab을 누르면 계획 모드로 전환됩니다.

이 모드에서는 AI가 파일을 직접 수정하지 않습니다. 대신 먼저 탐색하고 계획을 세운 후, 실행 전에 계획을 사용자에게 보여주고 확인을 받습니다.

“01-notes/ 폴더의 구조를 정리해줘” 또는 “이 노트들을 하나의 요약으로 합쳐줘” 같은 큰 작업에 적합합니다. 이런 작업을 바로 실행하면 AI가 예상치 못한 많은 변경을 할 수 있습니다. 먼저 계획을 검토하는 것이 나중에 난장판이 되어 실행 취소하는 것보다 훨씬 안전합니다.

권한 모드

Claudian에는 AI가 작업을 수행할 때 확인이 필요한지 제어하는 세 가지 권한 모드가 있습니다:

YOLO: 완전 자동. AI가 어떤 작업이든 팝업 없이 실행합니다. 가장 효율적이지만 AI의 판단을 신뢰해야 합니다.
Safe: AI가 파일을 수정할 때마다 팝업으로 확인을 요청합니다. 안전하지만 잦은 확인이 작업 흐름을 방해할 수 있습니다.
Plan: 위에서 설명한 계획 모드입니다. 먼저 계획을 세운 후 실행합니다.

일상적인 사용에는 YOLO로 충분합니다. Vault 구조를 더 중요하게 생각한다면 Safe를 사용하세요. 큰 작업 전에는 Plan으로 전환하여 먼저 검토하세요.

모델 선택

Haiku, Sonnet, Opus 사이를 전환하여 다양한 작업의 정밀도 요구를 충족할 수 있습니다. 간단한 질문에는 Haiku를 사용하여 토큰을 절약하고, 복잡한 노트 정리에는 Sonnet을, 심층 추론 작업에는 Opus를 사용하세요.

요약

오늘 배운 내용:

플러그인 방식과 터미널 방식의 핵심 차이: 창 전환 불필요, AI가 현재 노트를 자동으로 인식
Claudian은 Claude Code를 Obsidian 사이드바에 내장하는 플러그인이며, 내부적으로는 여전히 Claude Code CLI를 호출
설치에는 Claude Code CLI + Obsidian 1.8.9+가 필요하며, GitHub Release에서 수동 다운로드 또는 BRAT을 통해 설치 가능
핵심 기능: 사이드바 채팅, 현재 노트 자동 첨부, 인라인 편집, 이미지 지원, 슬래시 명령어, 계획 모드, 권한 제어

핵심 포인트:

터미널과 Skills를 다루고 싶지 않다면, Claudian이 진입 장벽이 낮은 선택지
이미 CLI + Skill 방식을 사용 중이라면, Claudian은 대체재가 아니라 작업을 더 매끄럽게 만드는 방법
인라인 편집은 정확한 부분 수정에, 계획 모드는 대규모 작업에 적합
권한 모드는 YOLO → Safe → Plan 순으로 신중해지며, 상황에 따라 선택

Karpathy 스타일 위키를 재사용 가능한 스킬로 전환하기

Mon, 01 Jan 0001 00:00:00 +0000

지난 며칠 동안 이 스킬을 작동시키는 데 정말 고생했습니다.

Opus 4.6으로 시작했습니다. 20달러 이상을 썼는데도 작동하지 않았습니다. 2026년 4월 8일 아침에 출시된 새 모델이 모든 컴퓨팅 자원을 다 잡아먹은 건 아닌지 의심하기도 했습니다. 그렇지 않으면 한순간에 이해하다가도 다음 순간에 엉뚱한 방향으로 갈 리가 없으니까요.

나중에 Codex로 전환했고, 겨우 만들 수 있었습니다.

하지만 새로운 문제가 생겼습니다. 만든다고 해서 안정적으로 작동하는 건 아니라는 점이었습니다.

특히 진지하게 테스트하기 시작하면 가끔 지시를 무시하고 마음대로 변경하는 일이 발생했고, 정말 미칠 노릇이었습니다.

그래서 이 글에서는 단순히 “스킬을 만들었으니 다운로드하세요"라고 말하고 싶지 않습니다.

대신 다른 점을 분명히 하고 싶습니다. Karpathy가 제안한 LLM Wiki 방법을 Obsidian 볼트에서 실제로 구현하는 방법입니다.

이전 장에서는 방법을 다뤘습니다. 이번 장은 실전입니다.

현재 제 스킬의 민감 정보를 제거한 버전을 다운로드하고 싶다면 다음 링크를 이용하세요:

https://blog.discoverlabs.ac.cn/downloads/obsidian-wiki-skill/

API 키, 로컬 경로 등은 이미 제거했습니다. 하지만 미리 말씀드리자면, 그대로 복사하지 마세요.

이 방법에서 배울 수 있습니다. 이 스킬을 수정할 수도 있습니다. 하지만 그대로 바로 작동할 거라고 기대하지 마세요. 모든 사람의 노트 볼트는 너무 다릅니다.

내가 만든 것은 “AI가 노트를 정리하는 것"이 아니라 “AI가 장부 정리를 하는 것”

먼저 Karpathy의 Gist를 다시 살펴보겠습니다.

원본 링크:

https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

핵심 아이디어는 사실 간단합니다.

현재 대부분의 사람들은 RAG를 통해 LLM으로 문서를 처리합니다. 파일을 한꺼번에 넣고, 질의할 때 검색해서 즉석에서 답변을 생성합니다.

물론 그렇게도 작동합니다.

하지만 문제는 모두 임시방편이라는 점입니다.

한 번 물어보면 한 번 조합합니다. 다시 물어보면 처음부터 다시 시작합니다. 축적이 없습니다.

그래서 그는 중간 계층을 제안했습니다. 매 질의마다 즉석에서 답변을 조합하지 말고, 지속적으로 Wiki를 유지 관리하라는 것입니다.

이 글을 읽었을 때 제 첫 반응은 “멋지다"가 아니었습니다.

이거야말로 Obsidian이 가장 잘하는 작업 아닌가? 였습니다.

Obsidian은 본질적으로 로컬 Markdown 파일 볼트이기 때문입니다.

Karpathy가 설명하는 Wiki는 기본적으로 Markdown 파일 모음입니다.

기본 형식이 거의 동일합니다.

차이점은 다음과 같습니다.

예전에는 백링크, 주제 페이지, 구조 페이지를 수동으로 유지 관리했습니다.
이제 AI가 이 “장부 정리” 작업을 도와줍니다.

참고: 장부 정리이지, 생각하는 것이 아닙니다.

점점 더 이 의견에 동의하게 됩니다.

글을 읽고, 판단하고, 자신의 의견을 쓰는 것은 여전히 여러분이 할 일입니다.

하지만 백링크 완성, 작성자 이름 정규화, 형식 확인, 파생 페이지 갱신 같은 작업은 본질적으로 잡일입니다. AI가 처리할 수 있습니다.

Obsidian에서 Karpathy의 3계층 구조를 구현한 방법

Karpathy 방법에서 가장 중요한 부분은 세 가지 계층입니다.

원시 소스(Raw Sources)
위키(The Wiki)
스키마(The Schema)

제 obsidian-wiki 스킬도 이 세 가지 계층을 기반으로 구축되었습니다.

첫 번째 계층: 원시 소스

제 볼트에서 이 계층은 다음으로 구성됩니다.

01-Notes/
04-Output/

즉, 원시 수집물, 원시 노트, 제가 쓴 글입니다.

이 계층을 매우 절제해서 유지합니다.

이 계층의 유일한 책임은 원본 콘텐츠를 보존하는 것입니다.

추가 기능을 부여하지 않습니다.

파생 콘텐츠를 섞지 않습니다.

원시 글이 반은 주제 페이지, 반은 색인 페이지가 되도록 두지 않습니다.

한번 섞이면 유지 관리가 어려워지기 때문입니다.

이 스킬을 만들면서 배운 가장 깊은 교훈 중 하나입니다. 원시 계층이 깨끗할수록 다른 모든 것이 쉬워집니다.

두 번째 계층: 위키

이 계층은 제 볼트에서 별도로 분리되어 있습니다.

01-Notes/wiki/

여기에는 AI가 파생한 구조 계층이 들어갑니다. 예를 들면:

작성자 페이지
주제 페이지
색인
로그
백링크 디렉터리

즉, 원문은 원문 그대로입니다.

위키는 위키입니다.

두 계층은 분리되어 있습니다.

사소해 보이지만 실제로 매우 중요합니다.

계층을 분리하지 않으면 AI가 정리할 때마다 원문이 더 지저분해지는 경향이 있기 때문입니다.

오늘은 주제 블록을 추가합니다.

내일은 색인을 삽입합니다.

모레는 자동 생성된 요약을 추가합니다.

결국 볼트 전체가 계속 치우는데도 더 지저분해지는 방이 됩니다.

세 번째 계층: 스키마

많은 사람들이 이 계층을 간과합니다.

Karpathy는 원문에서 스키마를 언급합니다. 제 이해는 볼트가 어떻게 생겨야 하는지 AI에게 알려줘야 한다는 것입니다.

제 경우에는 다음이 포함됩니다.

SKILL.md
여러 scripts/
프론트매터 규칙
작성자와 주제 작성 방식에 대한 제약
lint와 ingest에 대한 프로세스 제약

예를 들어, 현재 다음과 같은 규칙을 적용하고 있습니다.

작성자는 백링크 형식이어야 함
주제는 백링크 목록이어야 함
작성자 페이지와 주제 페이지는 오직 01-Notes/wiki/에만 위치해야 함
00-Inbox/는 처리용 인박스일 뿐, 위키에 직접 섞이지 않음
원시 글에는 더 이상 파생 문단이 포함되지 않음

알게 되겠지만, 스킬이 작동하게 만드는 것은 프롬프트가 얼마나 아름답게 쓰였느냐가 아닙니다. 진짜 핵심은 이러한 제약이 먼저 확립되어 있다는 점입니다.

세 가지 작업을 실행 가능한 워크플로로 변환하기

Karpathy는 또한 세 가지 핵심 작업을 제시합니다.

Ingest
Query
Lint

저도 같은 방식을 따랐습니다.

이 스킬의 실제 워크플로는 다음과 같습니다.

Ingest: wiki_lint.py --preflight + ob_shuanglian.py suggest/apply + wiki_ingest.py
Query: 먼저 wiki/index.md, authors/*.md, topics/*.md를 읽고, 필요하면 원문으로 돌아가 세부 내용 확인
Lint: wiki_lint.py, wiki_migrate.py, wiki_build_skeleton.py

Ingest: 새 콘텐츠를 볼트에 추가하기 전에 검사

AI가 “글을 보고 즉흥적으로 처리"하도록 두지 않습니다.

현재 워크플로는 사전 점검(preflight)으로 시작합니다.

먼저 프론트매터가 올바른지 확인합니다.

그다음 과거 오염(historical contamination)이 있는지 확인합니다.

그다음 백링크 제안을 만듭니다.

사용자가 확인한 후에야 실제로 적용합니다.

마지막으로 위키 파생 계층을 갱신합니다.

왜 이렇게 번거롭게 할까요?

모델이 여러 번 가르쳐줬기 때문입니다.

이런 가드레일을 추가하지 않으면, 모델이 열심히 “결정"을 내릴 것입니다.

문제는 그 결정이 여러분이 원하는 것이 아닐 수 있다는 점입니다.

그래서 강력한 확인 게이트를 추가했습니다.

주제를 마음대로 쓰지 못하게 합니다.

백링크를 바로 적용하지 못하게 합니다.

작성자 별칭을 스스로 결정하지 못하게 합니다.

제안을 하고, 제가 확인한 후에 씁니다.

덜 효율적으로 보일 수 있습니다.

하지만 지식 베이스에서 가장 두려운 것은 느린 것이 아니라 조용히 잘못된 것을 쓰는 것입니다.

Query: 원문의 바다에서 낚시하는 것이 아니라 먼저 위키 계층을 읽기

쿼리의 경우, 제 접근 방식은 “볼트 전체를 검색해서 AI에게 요약하라고 넘기는 것"이 아닙니다.

대신 먼저 다음을 거칩니다.

wiki/index.md
authors/*.md
topics/*.md

AI가 먼저 구조화된 계층을 보게 합니다.

필요할 때만 특정 글로 돌아가 세부 내용을 확인합니다.

장점은 분명합니다.

매번 흩어진 원문에서 다시 조합할 필요가 없습니다.

대신 이미 정리된 계층에서 답변합니다.

이는 Karpathy가 말하는 “축적"에 더 가깝습니다.

Lint: 가장 중요하면서도 가장 과소평가된 단계

많은 사람들이 LLM Wiki를 보면 Query에 집중합니다.

하지만 작업을 하면 할수록 Lint가 진정한 가치가 있는 곳이라는 생각이 듭니다.

지식 베이스가 커지면 가장 큰 골칫거리는 “답을 얻을 수 없다"가 아니라 다음과 같은 것들입니다.

프론트매터가 엉망
작성자 이름이 일관되지 않음
주제가 분산됨
원문에 역사적 구조가 남아 있음
파생 페이지가 점점 왜곡됨
같은 개념이 여러 다른 이름으로 나타남

이런 것들을 수동으로 유지 관리하려고 하면 정말 미칠 노릇입니다.

계속할 수도 없습니다.

바로 이것이 AI가 가장 잘하는 일입니다.

여러분을 대신해 세상을 이해하는 것이 아닙니다.

하지만 볼트를 순찰하고, 대조하고, 더티 데이터를 찾고, 상호 참조를 채워 넣는 것입니다.

그래서 Karpathy의 용어가 매우 적절합니다. 장부 정리(bookkeeping).

진짜 함정은 모델이 아니라, 내 오래된 노트 볼트

이것이 제가 가장 강조하고 싶은 점입니다.

많은 사람들이 이런 글을 읽고 본능적으로 생각합니다.

“아, 스킬을 다운로드해서 설치하면 AI가 내 지식 베이스를 관리해 주겠구나.”

그렇지 않습니다.

이 스킬의 가장 큰 도전 과제는 프롬프트, 스크립트, 심지어 모델도 아닙니다.

바로 오래된 노트가 너무 많고, 그 형식이 일관되지 않다는 점입니다.

지금 lint를 실행하면 다음과 같은 규모가 보입니다.

글 유형 원시 소스: 457개
전체 원시 파일: 833개
대기열: 249개
백링크 디렉터리에는 이미 471개의 주제가 있음

그 규모를 생각해 보세요.

이제는 “몇 개 노트를 정리하는” 수준이 아닙니다.

오히려 오랜 역사를 가졌지만 일관된 기준이 없는 낡은 시스템을 인수하는 것과 비슷합니다.

어떤 글은 전체 작성자 이름이 있습니다.

어떤 글은 별칭이 있습니다.

어떤 주제는 매우 상세합니다.

어떤 주제는 매우 분산되어 있습니다.

일부 오래된 파일에는 이전 구조의 잔재가 여전히 남아 있습니다.

그래서 점점 한 가지가 확실해졌습니다.

LLM Wiki를 구축하려면 첫 단계는 AI가 인수하도록 두는 것이 아닙니다. 첫 단계는 볼트를 “인수할 가치가 있는” 상태로 청소하는 것입니다.

그렇지 않으면 AI가 부지런할수록 엉망을 더 퍼뜨리게 됩니다.

그렇다면 이 스킬이 실제로 추가로 하는 일은 무엇인가?

Karpathy의 원문만 읽으면 매우 우아한 방법론이라고 생각할 것입니다.

하지만 실제로 구축하면서 채워야 할 많은 엔지니어링 세부 사항을 발견했습니다.

예를 들어:

프론트매터 표준화
작성자 별칭 정규화
주제에 백링크 형식 강제
원시 계층과 파생 계층 완전 분리
00-Inbox/를 처리용 인박스로 사용
주요 단계에 사용자 확인 게이트 추가
lint, migrate, ingest 같은 스크립트로 워크플로 분할

Karpathy가 이런 점을 생각하지 못한 것은 아닙니다.

그의 Gist는 패턴을 설명하는 것이지, 여러분의 볼트에 맞는 구체적인 구현을 설명하는 것이 아닙니다.

실제로 구현할 때는 이 계층을 직접 채워야 합니다.

현재 제 obsidian-wiki 스킬이 본질적으로 하는 일은 이것입니다.

추상적인 패턴을 제 Obsidian 볼트에서 실행되는 워크플로로 변환하는 것.

따라서 다운로드한다면 가장 중요한 것은 “내 디렉터리 구조를 복사하는 것"이 아닙니다.

왜 이렇게 계층을 나눴는지, 왜 여기서 확인이 필요한지, 왜 여기서 lint를 하는지, 왜 여기서 자동 적용을 사용하지 않는지를 이해하는 것입니다.

직접 해보고 싶다면, 먼저 이것들을 수정하세요

민감 정보를 제거한 버전을 제 블로그 다운로드 페이지에 올렸습니다.

https://blog.discoverlabs.ac.cn/downloads/obsidian-wiki-skill/

하지만 다운로드 후 가장 먼저 할 일은 실행하는 것이 아닙니다.

수정하는 것입니다.

적어도 다음 사항을 확인하세요.

볼트 경로가 제 경로와 동일한가?
01-Notes/, 04-Output/, 00-Inbox/ 구조가 동일한가?
프론트매터 필드가 제 것과 일관된가?
작성자 이름과 주제 이름이 이미 상당히 일관된가?
“제안, 확인, 기록” 워크플로를 유지하고 싶은가?
스크립트에 API가 관련되어 있다면 자신의 키로 교체했는가?

제가 공개한 버전은 API 키와 로컬 경로를 이미 제거했습니다.

받은 후에는 자신의 환경에 맞게 조정해야 합니다.

그리고 여전히 권장합니다. 제 방법을 템플릿으로 취급하지 말고 참고 자료로만 사용하세요.

볼트가 주로 독서 노트라면 규칙이 제 것과 다를 수 있습니다.

볼트가 주로 프로젝트 노트라면 주제의 세분화 수준이 다를 것입니다.

볼트가 아직 “일단 모으고 나중에 정리” 단계라면 Query보다는 Lint와 Ingest를 먼저 안정적으로 만드는 데 집중해야 할 것입니다.

그러니 그대로 복사하지 마세요.

접근 방식을 바탕으로 수정하는 것이 더 안정적입니다.

요약

이 글을 마무리하면서 제 자신의 느낌이 더 분명해졌습니다.

Karpathy의 제안은 단순히 “AI가 지식 베이스를 정리하는 데 도움을 줄 수 있다"는 아이디어가 아닙니다.

그 진정한 가치는 지식 관리에서 인간과 AI의 역할 분담을 재정의했다는 점입니다.

인간은 판단을 담당합니다.

AI는 장부 정리를 담당합니다.

이 작업을 하면 할수록 그 말이 더 믿어집니다.

오늘 배운 점:

Karpathy의 LLM Wiki 핵심은 세 가지 계층 구조와 세 가지 작업이지, 단일 프롬프트가 아니다
obsidian-wiki 같은 스킬의 핵심은 “요약을 잘하느냐"가 아니라 Raw Sources, Wiki, Schema를 분리할 수 있느냐이다
실제로는 Lint가 Query보다 더 중요한 경우가 많다. 역사적 데이터 정리가 작업의 대부분이기 때문이다
오래된 노트가 많고 형식이 엉망일수록 다른 사람의 스킬을 그대로 복사해서는 안 된다
스킬을 다운로드하는 것은 쉽다. 진짜 도전은 자신의 지식 베이스에 맞게 조정하는 것이다

핵심 정리:

AI는 생각을 대신하는 것이 아니라 장부 정리에 가장 적합하다
원시 계층과 파생 계층은 반드시 분리해야 한다. 그렇지 않으면 정리할수록 지식 베이스가 더 엉망이 된다
사용자 확인 게이트는 추가 단계가 아니라 AI가 마음대로 행동하지 못하게 하는 필수 가드레일이다
형식을 먼저 표준화한 후에 자동화를 논하라. 순서를 바꾸면 나중에 고생한다
이 스킬은 수정할 수 있지만, 그대로 복사하는 것은 권장하지 않는다

Obsidian Base: 나만의 갤러리와 데이터 테이블 만들기

Mon, 01 Jan 0001 00:00:00 +0000

많은 사람들이 예전에 Obsidian과 Notion을 비교하면서 가장 아쉬워했던 점은 바로 이것이었습니다. Obsidian은 무료인데, 테이블, 카드, 데이터베이스가 항상 부족하다는 느낌이 들었죠.

예전에는 Obsidian에서 제대로 된 데이터베이스를 만들려면 보통 플러그인에 의존하거나 Properties와 Dataview를 수동으로 조합해야 했습니다. 가능은 했지만 진입 장벽이 높았습니다. 이제 공식 Base 기능이 그 격차를 상당 부분 메워줬습니다.

Obsidian을 또 다른 Notion으로 만든 것은 아니지만, 자신의 볼트 안에서 테이블, 리스트, 카드 라이브러리, 영화 갤러리, 미디어 라이브러리 등을 만들 수 있을 정도는 됩니다.

이 글에서는 Base가 무엇인지, 어떻게 만드는지, 그리고 가장 실용적이고 초보자에게 친숙한 두 가지 방향인 테이블 만들기와 영화 갤러리 만들기를 설명하겠습니다.

Base란 무엇인가?

먼저, 가장 중요한 점: Base는 노트를 신비로운 새 시스템으로 바꾸는 것이 아니라, 기존 Markdown 파일에 데이터베이스 뷰 계층을 추가하는 것입니다.

파일 형식은 .base이며, 이는 “데이터베이스 설정 파일"이라고 생각하면 됩니다. 이 파일은 다음을 정의합니다:

표시할 노트
사용할 뷰
필터링 방법
정렬 방법
표시할 속성

즉, 데이터는 여전히 그 Markdown 파일들입니다. Base는 단지 더 직관적인 방식으로 데이터를 정리해줄 뿐입니다.

이 점이 Notion과 크게 다른 부분이기도 합니다.

Notion의 데이터베이스는 본질적으로 데이터베이스 자체인 반면, Obsidian의 Base는 본질적으로 여전히 파일 중심입니다. 여러분이 보는 하나의 행, 카드, 항목은 대개 실제 파일 하나에 해당합니다.

여기에는 장단점이 있습니다:

장점은 콘텐츠가 여전히 로컬에, 여러분의 폴더 안에 있으며, 플랫폼에 종속되지 않는다는 점입니다.

단점은 데이터베이스, 목록, 독서 목록, 미디어 라이브러리, 프로젝트 목록에는 적합하지만, “매초를 복잡한 구조로 기록하는” 시스템에 사용하려면 접근 방식을 조정해야 한다는 점입니다.

Base를 만드는 방법?

만드는 것은 사실 매우 간단합니다. 왼쪽 파일 탐색기에서 폴더를 마우스 오른쪽 버튼으로 클릭하면 새 옵션이 나타납니다: 새 데이터베이스.

클릭하면 Obsidian이 .base 파일을 생성합니다. 이 파일은 데이터 자체가 아니라 이 데이터베이스 뷰의 “설명서"입니다.

이 단계는 중요합니다. 많은 초보자들이 “테이블을 만드는 중"이라고 오해하기 때문입니다. 실제로는 그렇지 않습니다. 여러분은 파일을 보는 새로운 방식을 만드는 것입니다.

예를 들어, 폴더에 Base를 만들면 범위 내의 많은 노트를 가져오는 경우가 많습니다. 당황하지 마세요. 다음 단계는 데이터를 입력하는 것이 아니라 제어하는 방법을 배우는 것입니다.

오른쪽 상단의 버튼들을 이해하면 Base의 요령을 기본적으로 익힌 것입니다:

정렬: 무엇을 먼저 볼지 결정
필터: 이 뷰에 무엇을 포함할지 결정. 예를 들어, 이 데이터베이스가 어떤 폴더의 파일을 표시할지 여기서 설정합니다. 그렇지 않으면 기본적으로 모든 노트가 들어올 수 있습니다.
속성: 이 열에 무엇을 표시할지 결정
검색: 현재 Base 결과 내에서 검색
새로 만들기: 이 Base에 새 항목을 직접 추가

Base를 어떻게 사용하나요?

데모를 위해 Demo-Base.base 파일을 만들었고, 가장 일반적인 세 가지 뷰를 사용했습니다:

테이블
카드
리스트

이 방식은 실제로 일상적으로 사용하기에 좋습니다. 대부분의 경우 “매우 복잡한 데이터베이스"가 필요하지 않고, 동일한 콘텐츠를 상황에 따라 다른 방식으로 보는 것이 필요하기 때문입니다.

예를 들어, 글 자료를 정리할 때는 테이블이 속성을 한꺼번에 보기에 좋고, 미디어 라이브러리를 만들 때는 카드가 가장 직관적이며, 제목만 빠르게 훑어보고 싶을 때는 리스트가 가장 빠릅니다.

첫 번째, 가장 실용적인: 테이블 뷰

테이블 뷰는 가장 이해하기 쉽습니다. 기본적으로 여러 노트를 행과 열로 배열하는 것입니다.

Excel과 매우 유사하며, Notion의 클래식 테이블 데이터베이스 뷰와도 비슷합니다.

이 모드는 특히 다음에 좋습니다:

파일의 제목, 날짜, 태그, 카테고리 보기
속성이 올바르게 채워졌는지 일괄 확인
날짜, 평점, 우선순위 등으로 빠르게 정렬
가벼운 데이터 관리(예: 책 목록, 프로젝트 목록, 지출 기록)

Base를 처음 사용한다면 아직 수식, 링크, 복잡한 구조는 생각하지 마세요. 먼저 필터, 정렬, 속성 표시라는 세 가지 기능에 익숙해지세요.

현재 Base의 가장 큰 가치는 기술을 자랑하는 것이 아니라, 마침내 Obsidian에서 콘텐츠를 더 인간 친화적인 방식으로 관리할 수 있게 해준다는 점이기 때문입니다.

리스트 뷰: 가장 평범하지만, 가장 빠르다

많은 사람들이 리스트 뷰를 간과합니다. 테이블처럼 전문적으로 보이지도 않고, 카드처럼 화려하지도 않기 때문입니다. 하지만 리스트 뷰에는 큰 장점이 있습니다: 가볍다.

파일 제목을 빠르게 훑어보거나, 필터 결과를 바탕으로 내용을 훑어보고 싶을 때 리스트 뷰가 사실 가장 편리합니다.

특히 다음에 좋습니다:

최근에 작성한 내용 훑어보기
특정 태그 아래에 어떤 글이 있는지 확인
폴더에 원치 않는 콘텐츠가 있는지 빠르게 확인
“검색 결과 페이지"로 사용

때로는 도구가 단순할수록 더 자주 사용됩니다. 리스트 뷰가 바로 그런 것입니다.

카드 뷰: 여기가 Notion과 가장 비슷한 부분

테이블 뷰가 “관리 문제"를 해결한다면, 카드 뷰는 “표시 문제"를 해결합니다.

이 인터페이스를 보면 예전 Obsidian과 다르다는 것을 바로 느낄 수 있습니다. 카드가 배치되면 볼트 전체의 콘텐츠가 “파일 목록"에서 “콘텐츠 패널"로 즉시 변신합니다.

이 모드는 특히 다음에 좋습니다:

영화 라이브러리
책 라이브러리
이미지 라이브러리
프로젝트 칸반 스타일 브라우징
글 주제 풀

개인적으로 Base의 가장 가치 있는 부분은 테이블이 아니라 카드라고 생각합니다. 많은 도구가 테이블을 할 수 있지만, Obsidian이 이전에 가장 부족했던 것은 “노트를 시각적인 자료 라이브러리로 바꾸는” 능력이었기 때문입니다.

Notion과 비슷한 영화 갤러리를 만들고 싶다면 아이디어는 간단합니다:

각 영화마다 노트 하나
각 노트에 몇 가지 기본 속성 추가
포스터 이미지를 담을 “Cover” 속성을 별도로 준비
그런 다음 카드 뷰에서 커버 이미지 소스를 이 “Cover” 속성으로 설정

결과는 Notion의 갤러리 스타일 표시와 매우 가까워집니다.

완전한 실습 예제: 영화 갤러리를 처음부터 구축하기

방금 만든 예제를 사용하겠습니다. 파일은 매우 간단하게 두 개입니다:

The Shawshank Redemption.md
Farewell My Concubine.md

목표는 명확합니다: 이 두 노트를 Base에서 포스터가 있는 두 개의 영화 카드로 표시하는 것.

1단계: 두 개의 영화 노트 준비

가장 간단한 방법은 영화당 하나의 파일입니다. 예를 들어, 00-Inbox에 두 개의 노트를 만듭니다:

The Shawshank Redemption
Farewell My Concubine

이 단계에서는 긴 내용을 작성할 필요가 없습니다. 파일에 제목만 있어도 괜찮습니다. Base에게 가장 중요한 것은 본문이 아니라 속성이기 때문입니다.

2단계: 노트에 “Cover” 및 “Category” 속성 추가

노트 중 하나(예: Farewell My Concubine.md)를 열고, 상단의 “노트 속성” 영역에서 두 가지 속성을 추가합니다:

Cover
Category

여기서:

Cover는 영화 포스터용
Category는 “Movie"로 표시

Obsidian에서 “노트 속성 추가"를 클릭하면 직접 할 수 있으며, YAML을 수동으로 작성할 필요가 없습니다.

초보자들이 자주 막히는 부분이니 분명히 말씀드리자면: 카드 뷰의 포스터는 본문에 삽입된 일반 이미지를 보지 않고, 속성에 있는 이미지를 봅니다.

즉, 포스터를 본문에만 넣으면 Base가 카드 커버로 인식하지 않을 수 있지만, 포스터를 Cover 속성에 넣으면 안정적으로 읽어옵니다.

예를 들어, 이 영화 노트는 결국 다음과 같은 구조가 됩니다:

---
Cover: "[[05-Archive/Gallery/PixPin_2026-04-02_10-05-21.webp]]"
Category:
  - Movie
---

이렇게 수동으로 작성할 필요는 없습니다. Obsidian의 속성 패널이 대신 해주기 때문입니다. 하지만 내부가 어떻게 생겼는지 알면 나중에 문제 해결이 더 쉬워집니다.

3단계: 전용 Base 파일 만들기

그런 다음 왼쪽 폴더에서 마우스 오른쪽 버튼을 클릭하고 새 데이터베이스를 만들면 .base 파일이 생성됩니다. 여기서는 Demo-Base.base를 사용합니다.

이 파일은 “전시장 자체"라고 생각하면 되고, 두 개의 영화 노트는 “전시품"입니다. Base는 표시를 담당하고, 실제 데이터는 여전히 각각의 Markdown 노트에 저장됩니다.

4단계: 범위를 이 두 영화로만 좁히기

많은 사람들이 Base를 처음 사용할 때 문제가 있습니다. 열면 볼트 전체의 모든 노트가 들어오기 때문입니다. 따라서 이 단계는 필수입니다. 먼저 범위를 필터링하세요.

Base 오른쪽 상단의 “필터"를 클릭하여 표시하려는 콘텐츠만 유지할 수 있습니다. 예를 들어:

특정 폴더의 노트만
특정 태그가 있는 노트만
category가 “Movie"인 노트만
또는 데모처럼 이 두 개의 특정 파일만

초보자에게는 먼저 “폴더 범위” 또는 “category = Movie"를 사용하는 것이 더 직관적이므로 추천합니다.

5단계: 카드 뷰로 전환하고 커버 소스 지정

이것이 가장 중요한 단계입니다. 카드 뷰로 전환한 후 Base에 알려줘야 합니다: 카드 커버에 어떤 속성의 이미지를 사용할지.

여기서는 앞서 만든 Cover를 선택합니다.

이 단계만 올바르게 하면 카드가 즉시 일반 텍스트 블록에서 실제 영화 포스터 갤러리로 변신합니다.

여기 또 초보자를 혼란스럽게 할 수 있는 점이 있습니다. 오른쪽 상단의 “속성"을 클릭하면 카드 아래에 표시할 필드(예: Name, Category)를 선택하는 것입니다. 하지만 포스터 표시 여부는 여기서 제어되지 않습니다.

포스터는 카드 커버의 일부이며, 그 소스는 카드 뷰에서 별도로 지정한 Cover 속성입니다. 따라서 “속성” 메뉴에서 Cover를 체크하지 않아도 위의 포스터는 정상적으로 표시됩니다.

즉, 두 가지 설정이 있습니다:

Cover: 카드 상단의 포스터 제어
Name, Category: 카드 아래에 표시되는 텍스트 정보 제어

이제 Farewell My Concubine과 The Shawshank Redemption이 Notion과 매우 유사한 영화 갤러리가 되었습니다. 카드 상단에는 포스터가, 하단에는 파일 이름과 속성이 표시됩니다. 지금은 두 개의 영화만 있지만, 이 패턴의 가치를 이미 볼 수 있습니다. 나중에 영화를 더 추가하면 전체 라이브러리가 진정한 미디어 아카이브로 성장할 것입니다.

6단계: 나중에 더 추가할 수 있는 것은?

“Cover + Category"가 작동하게 되면 나머지는 간단합니다. 각 영화에 다음과 같은 속성을 계속 추가할 수 있습니다:

연도
감독
국가/지역
평점
시청 여부
재시청 횟수
한 줄 평

그러면:

카드 뷰는 “보기 좋게” 담당
테이블 뷰는 “관리하기 쉽게” 담당

이것이 Base를 가장 편안하게 사용하는 방법입니다: 동일한 콘텐츠에 대해 표시와 관리를 분리하는 것.

이 예제가 초보자에게 적합한 이유

진입 장벽이 거의 없기 때문입니다. 먼저 수식을 배울 필요도, Dataview를 배울 필요도, 복잡한 템플릿을 만질 필요도 없습니다. 다음 세 가지만 이해하면 됩니다:

영화 하나 = 노트 하나
포스터를 본문에만 넣지 말고 속성에 넣기
카드 뷰의 포스터 소스를 “Cover” 속성으로 설정

이 세 가지만 이해하면 영화 라이브러리, 책 라이브러리, 게임 라이브러리, 여행 사진 라이브러리 모두 동일한 패턴을 따릅니다.

그리고 기본 파일이 여전히 Markdown이기 때문에 영화 라이브러리는 데이터베이스에 갇히지 않고 실제 로컬 노트 세트로 남습니다. 나중에 마이그레이션, 백업, AI 처리를 위해 넘겨주기가 폐쇄형 플랫폼보다 훨씬 편안합니다.

필터, 정렬, 속성: 이 세 가지가 Base의 핵심

많은 사람들이 Base를 처음 열면 “테이블 / 카드 / 리스트” 뷰 전환 버튼을 오랫동안 응시합니다. 하지만 이 기능이 유용한지 여부를 실제로 결정하는 것은 뷰 자체가 아니라 오른쪽 상단의 세 가지 버튼입니다:

필터: 누가 들어올지 결정
정렬: 누구를 먼저 볼지 결정
속성: 무엇을 볼지 결정

이 세 가지를 이해하면 Base는 “새로운 기능"에서 “실제로 작동하는 도구"로 변신합니다.

예를 들어, 데모에서 카드 뷰는 콘텐츠 갤러리에 좋으므로 필터를 사용하여 특정 폴더를 제외하고 표시에 적합한 콘텐츠만 유지할 수 있습니다. 그러면 카드가 훨씬 깔끔해집니다.

반면 테이블 뷰는 필드를 노출하는 데 더 좋아서 일괄 확인 및 조정이 쉽습니다.

즉: 동일한 파일 세트, 다른 뷰는 중복이 아니라 분업입니다.

이것이 Base가 Notion과 가장 비슷하면서도 여전히 Obsidian다운 점입니다.

장부(가계부)로 사용할 수 있나요?

가능합니다. 하지만 제 생각에는: 할 수는 있지만, 가장 편안하지는 않을 수 있습니다.

장부 습관이 “하나의 기록 = 하나의 독립 항목"이라면 Base가 적합합니다. 각 기록에 금액, 날짜, 카테고리, 결제 수단 등의 속성을 추가한 다음 테이블에서 필터, 정렬, 계산을 할 수 있습니다. 논리는 맞습니다.

하지만 하나의 Markdown 파일에 연속적인 흐름을 기록하는 데 익숙하다면 Base는 덜 편리합니다. Base의 많은 기능이 “한 행의 콘텐츠 = 하나의 파일” 을 가정하기 때문입니다.

따라서 제게는 현재 다음과 같은 용도에 더 좋습니다:

이미지 라이브러리
책 라이브러리
영화 라이브러리
글 자료 풀
프로젝트 목록

빈도가 높은 거래 로그보다는요. 이것은 Obsidian에 대한 오랜 제 견해이기도 합니다: 처음부터 모든 것을 하나로 통합하려고 하지 마세요.

Base는 확실히 강력하지만, 가장 좋은 사용법은 모든 것을 대체하도록 강요하는 것이 아니라 적절한 위치에 두는 것입니다.

어떻게 사용을 시작하는 것이 좋을까요?

아직 Base를 사용하지 않았다면, 바로 거대한 시스템을 구축하지 않는 것이 좋습니다. 시작하는 가장 좋은 방법은 실제로 두 가지입니다:

첫째, 갤러리를 만드세요. 예를 들어 영화, 책, 글 커버, 여행 사진, 수집 자료 등은 모두 카드 뷰에 좋습니다. Base의 가치를 즉시 이해할 수 있습니다.

둘째, 가벼운 테이블을 만드세요. 예를 들어 프로젝트 목록, 정리할 자료, 독서 기록 등이 있습니다. 그러면 자연스럽게 정렬, 필터링, 속성 표시를 사용하게 됩니다.

이 두 가지 시나리오를 경험하면 기본적으로 Base를 알게 됩니다.

요약

Base의 출시로 Obsidian은 더 이상 “Markdown을 작성할 수 있는 노트 앱"에 그치지 않고, 진정한 데이터베이스 느낌을 갖추기 시작했습니다. 하지만 핵심 장점은 Notion과 누가 더 데이터베이스 같은지 경쟁하는 것이 아니라: 로컬 파일에 처음으로 충분히 편리한 데이터베이스 뷰를 제공한다는 점입니다.

이것은 매우 중요합니다. 예전에는 많은 콘텐츠가 관리할 수 없어서가 아니라 관리하기 어려웠고, 볼 수 없어서가 아니라 보기 어려웠기 때문입니다. 이제 Base 덕분에 이전에 플러그인이 필요했던 많은 시나리오를 마침내 직접 처리할 수 있게 되었습니다.

오늘 배운 내용:

Base의 본질은 기존 Markdown 파일에 데이터베이스 뷰 계층을 추가하는 것
만드는 방법은 간단: 왼쪽 폴더를 마우스 오른쪽 버튼으로 클릭하여 새 데이터베이스 생성
Base에서 가장 중요한 것은 화려함이 아니라 필터, 정렬, 속성이라는 세 가지 핵심 작업
테이블은 관리에, 리스트는 빠른 탐색에, 카드는 영화 갤러리와 미디어 라이브러리에 가장 적합
표시 중심 데이터베이스에는 좋지만, 모든 고빈도 거래 시나리오에 반드시 적합한 것은 아님

핵심 포인트:

.base 파일 자체는 데이터가 아니라 데이터베이스 뷰 설정
한 행의 콘텐츠는 일반적으로 실제 노트 파일 하나에 해당
카드 뷰는 Notion의 갤러리 효과에 가장 가까움
가장 빠르게 시작하려면 먼저 영화 갤러리를 만든 다음 가벼운 테이블 만들기
처음부터 모든 것을 통합하려고 생각하지 말고, Base가 가장 적합한 시나리오에 먼저 사용하기

Obsidian Canvas: 아이디어를 시각적으로 정리하기

Mon, 01 Jan 0001 00:00:00 +0000

폴더 계획(몇 개의 간단한 폴더로 노트 시스템 운영하기)에 대해 다뤘습니다. 이제 Obsidian에 내장된 또 다른 핵심 플러그인인 Canvas를 살펴보겠습니다.

Canvas란 무엇이며, 어떤 점이 좋고, 어떤 점이 좋지 않은가

간단히 말해, Canvas는 무한 캔버스입니다.

일반 노트는 선형적입니다. 위에서 아래로 작성하며 내용이 순차적으로 이어집니다. Canvas는 다릅니다. 2차원이며 경계가 없습니다. 노트, 이미지, 웹 링크, 텍스트 카드를 끌어다 놓고, 선을 사용하여 관계를 설정할 수 있습니다.

Canvas가 유용한 상황:

복잡한 프로젝트 분해: 큰 목표를 여러 하위 작업으로 나누고, 선으로 의존 관계를 표시
지식 관계도: 한 분야의 개념이 너무 많을 때, Canvas로 연결 관계를 한눈에 파악
시각적 독서 노트: 책의 핵심 주장, 뒷받침 사례, 반론 등을 선형 노트보다 훨씬 직관적으로 배치
순서도 / 아키텍처 다이어그램: 제품 흐름, 기술 아키텍처, 워크플로우 등을 그림으로 그리면 글로 쓰는 것보다 이해하기 쉬움

Canvas가 적합하지 않은 상황:

선형 콘텐츠에는 일반 노트를 사용하세요. Canvas를 사용하기 위해 억지로 사용하지 마세요.

글을 쓰거나, 회의록을 작성하거나, 목록을 정리할 때는 .md 파일을 사용하세요. Canvas를 열면 추가 작업이 발생합니다. Canvas의 가치는 공간적 배치가 필요한 콘텐츠에 있습니다. 콘텐츠 간에 복잡한 관계가 있을 때만 사용하세요.

Canvas 핵심 플러그인 활성화하기

Canvas는 Obsidian에 내장된 핵심 플러그인이므로 설치가 필요 없습니다. 기본적으로 비활성화되어 있으므로 수동으로 활성화해야 합니다.

경로: 설정 → 핵심 플러그인 → “Canvas” 찾기 → 오른쪽 토글 스위치 켜기.

활성화하면 왼쪽 사이드바에 Canvas 아이콘이 나타납니다. 클릭하여 새 Canvas 파일을 만들 수 있습니다.

Canvas 만들기 및 사용하기

새 Canvas를 만드는 방법

세 가지 방법이 있습니다:

명령어 팔레트: Cmd+P(Mac) 또는 Ctrl+P(Windows), “새 Canvas” 검색 후 Enter
왼쪽 사이드바: Canvas 플러그인을 활성화하면 왼쪽 사이드바에 Canvas 아이콘이 나타납니다. 클릭하여 새로 만들기

생성 후 .canvas 파일이 생성됩니다(자세한 내용은 아래에서 설명).

일반적인 작업 및 단축키

Canvas의 작동 방식은 일반 그림판과 비슷하므로 쉽게 익힐 수 있습니다:

작업	단축키
새 텍스트 카드 만들기	빈 공간 더블클릭
카드 편집 종료	Esc
캔버스 이동	Space + 드래그, 또는 마우스 가운데 버튼 드래그
캔버스 확대/축소	Ctrl/Cmd + 마우스 휠
모든 콘텐츠를 화면에 맞추기	Shift+1
선택한 콘텐츠를 화면에 맞추기	Shift+2
카드 삭제	선택 후 Backspace 또는 Delete
두 카드 연결	카드 가장자리에 마우스를 올리면 나타나는 점에서 드래그

가장 자주 사용하는 두 가지는: 더블클릭으로 카드 만들기와 가장자리 점에서 드래그하여 연결하기입니다.

키보드 워크플로우: 키보드에서 손을 떼지 않고 브랜치 만들기

Canvas는 순수 키보드 워크플로우도 지원하므로, 빠르게 브레인스토밍하고 연속적으로 브랜치를 만들기에 이상적입니다.

기본 탐색(편집 모드가 아닐 때):

작업	단축키
다음/이전 카드로 선택 전환	Tab / Shift+Tab
인접한 연결된 카드로 이동	← → ↑ ↓
선택한 카드 편집 모드로 전환	Enter
편집 모드 종료, 카드 선택으로 돌아가기	Esc
모든 카드 선택	Ctrl/Cmd + A
선택한 카드 삭제	Backspace 또는 Delete

브랜치 만들기: 카드를 선택한 후(편집 모드 아님), 마우스를 카드 가장자리로 이동합니다. 네 면 모두 원형 연결점이 있습니다. 하나를 빈 영역으로 드래그합니다. 기존 카드 위가 아니라 빈 공간으로 드래그한 후 놓으면 메뉴가 나타납니다. “새 텍스트 카드"를 선택하면 새 카드가 자동으로 생성되어 현재 카드와 연결됩니다.

여러 병렬 브랜치를 만드는 키보드+마우스 워크플로우:

빈 공간을 더블클릭하여 부모 카드를 만들고, 내용을 입력한 후 Esc를 눌러 편집 종료
카드가 선택된 상태에서 오른쪽 가장자리 점을 드래그 → 자식 카드 1 생성, 내용 입력 후 Esc
화살표 키 ←를 사용하여 부모 카드로 돌아가기
다시 오른쪽 가장자리 점을 드래그 → 자식 카드 2 생성, 내용 입력 후 Esc
3~4단계를 반복하여 병렬 자식 브랜치 세트를 빠르게 생성

이 워크플로우의 핵심은: 마우스로 카드를 만들고, 키보드로 입력 및 전환하며, 둘 사이의 전환 비용이 낮다는 점입니다. 마우스를 완전히 사용하지 않으려면 Canvas로는 현재 불가능합니다. Obsidian은 아직 순수 키보드로 연결된 카드 생성을 지원하지 않습니다. 순수 키보드 마인드맵을 원한다면 다음 장의 Excalidraw를 기다리거나, 전용 마인드맵 도구를 사용하세요.

Canvas에 추가할 수 있는 것들

Canvas에는 텍스트 카드 외에도 다양한 것을 추가할 수 있습니다:

텍스트 카드: 빈 공간을 더블클릭하고 직접 입력합니다. Markdown 형식을 지원합니다. 제목, 목록, 굵게 등 일반 노트와 동일합니다.

기존 노트 파일: 파일 트리에서 Canvas로 직접 드래그하거나, Canvas 빈 공간에서 마우스 오른쪽 버튼 → “보관소에서 파일 추가”. 드래그한 후 노트 내용이 카드에 미리보기로 표시되며, 직접 편집할 수 있습니다.

노트의 특정 단락: 노트에서 원하는 단락을 선택한 후 Canvas로 드래그하면 전체 파일이 아닌 해당 내용만 추가됩니다. 책 노트를 분해할 때 유용합니다.

이미지: 파일 트리나 시스템 폴더에서 이미지 파일을 Canvas로 드래그하면 직접 표시됩니다.

웹 링크: 링크를 Canvas에 붙여넣고 마우스 오른쪽 버튼을 클릭한 후 “링크 카드로 변환"을 선택하면 페이지 제목과 미리보기가 표시됩니다.

핵심 포인트! AI를 사용하여 Canvas 그리기

Canvas는 수동으로 그릴 수 있지만, 더 쉬운 방법이 있습니다. AI가 대신 생성하도록 하는 것입니다.

배경

먼저 Claude Code를 간략히 소개합니다. Anthropic의 AI 프로그래밍 CLI 도구입니다. Skills로 확장할 수 있습니다(자세한 사용법은 이 책의 5부 AI 협업에서 다룹니다). Obsidian 개발자 kepano가 Claude Code 전용 obsidian-skills 세트를 만들었는데, 여기에는 json-canvas라는 Skill이 포함되어 있어 Claude Code가 .canvas 파일을 만들고 편집할 수 있도록 가르칩니다.

URL: https://github.com/kepano/obsidian-skills/tree/main/skills/json-canvas

설치 방법

터미널에서 실행:

git clone https://github.com/kepano/obsidian-skills.git ~/.claude/skills/obsidian-skills

또는 웹사이트를 열어 직접 다운로드한 후, 이 폴더를 만들어 skills 디렉토리에 배치할 수 있습니다.

사용 방법

Claude Code에서 /json-canvas를 입력하고, 이 Skill을 선택한 후 Tab을 누르고, 그리고 그리고 싶은 내용을 자연어로 설명합니다. Claude Code가 Obsidian 보관소에 직접 .canvas 파일을 생성합니다.

실제 데모

폴더 계획 장의 폴더 구조를 데모로 사용했습니다. Claude Code에게 “폴더 계획 장의 폴더 구조를 Canvas로 그려 주세요. 각 폴더의 기능과 흐름 관계를 보여 주세요.“라고 말했습니다.

Claude Code가 글을 읽은 후 직접 .canvas 파일을 생성하여 00 Inbox에 배치했습니다. 파일 내용은 표준 JSON Canvas 형식입니다. 각 폴더가 카드에 해당하며, 색상 코딩과 화살표로 흐름 관계를 나타냅니다:

00 Inbox가 진입점 역할을 하고, 정리된 콘텐츠가 01 Notes와 04 Output으로 흐르며, 01 Notes의 콘텐츠는 다시 04 Output으로 흐르는 등 전체 흐름이 한눈에 보입니다. 이 관계를 글로 설명하려면 여러 번의 설명이 필요하지만, 다이어그램에서는 3초 만에 이해됩니다.

이것이 AI + Canvas의 실용적인 조합입니다. 노트나 글을 Claude Code에 바로 던져주면, 자동으로 구조를 추출하고 관계도를 그려줍니다. 수동으로 카드를 만들고 연결을 드래그하는 것보다 훨씬 빠릅니다.

.canvas 형식에 대해, 한 가지 분명히 할 점

Canvas 파일은 .md 형식이 아니라 .canvas 형식입니다.

.canvas 파일은 JSON 형식의 일반 텍스트 파일로, 각 카드의 위치, 크기, 내용 및 카드 간의 연결을 저장합니다. .md 파일과 병렬로 존재합니다. 파일 트리에서 .canvas 파일은 별도로 표시되며, 노트 파일과 분리되어 저장됩니다.

즉, Canvas는 별도로 관리해야 합니다. 하나의 .md 파일에 텍스트를 쓰면서 Canvas를 포함시킬 수 없습니다. Canvas는 별도 파일이고, 텍스트는 또 다른 파일이며, 독립적으로 존재합니다.

참고로 JSON Canvas는 Obsidian 전용 독점 형식이 아니라 오픈 표준(MIT 라이선스)이며, 이미 많은 도구에서 지원합니다. 하지만 “별도로 관리해야 한다"는 문제는 여전히 남아 있습니다.

요약

오늘 배운 내용:

Canvas = 무한 캔버스: 공간적 배치와 관계 구축이 필요한 콘텐츠에 적합. 선형 콘텐츠에는 억지로 사용하지 말 것
활성화 방법: 설정 → 핵심 플러그인 → Canvas → 스위치 켜기
핵심 작업: 더블클릭으로 카드 만들기, 가장자리 점에서 드래그하여 연결, Space+드래그로 캔버스 이동
키보드 워크플로우: Tab/Shift+Tab으로 카드 전환, ↑↓←→로 이동, Enter로 편집, Esc로 종료. 연결된 카드 만들기는 점을 빈 공간으로 드래그해야 함. 순수 키보드 생성은 아직 지원되지 않음
Canvas에 추가할 수 있는 것: 텍스트 카드, 기존 노트, 노트 단락, 이미지, 웹 링크
json-canvas Skill: Claude Code가 노트를 읽고 자동으로 .canvas 파일을 생성, 수동 그리기보다 훨씬 빠름
형식 참고: Canvas는 .canvas(JSON)로 저장되며, .md가 아님. 별도로 관리 필요

Obsidian Properties: 노트를 검색 가능하게 만들기

Mon, 01 Jan 0001 00:00:00 +0000

이 장에서는 Obsidian의 Properties에 대해 알아보겠습니다.

이전 장에서는 Obsidian을 더 강력하게 만드는 플러그인을 다뤘습니다. 이 장에서는 덜 화려하지만 매우 실용적인 기능인 각 노트에 메타데이터를 추가하는 방법을 다룹니다.

Properties란 무엇인가?

노트를 열고 오른쪽 상단의 점 세 개(⋯)를 클릭한 후 ‘속성 추가’를 선택하세요.

노트 상단에 표 같은 영역이 나타납니다. 왼쪽은 속성 이름, 오른쪽은 속성 값입니다. 왼쪽에서는 Obsidian의 내장 속성(예: 태그, 별칭)을 선택하거나 직접 이름을 입력하여 새 속성을 만들 수 있습니다. 오른쪽에는 해당 내용을 입력합니다.

정말 간단합니다. 코딩이 필요 없습니다.

YAML은 무엇인가요?

소스 모드(설정 → 편집기 → 기본 편집 모드 → 소스 모드)로 전환하면 속성이 실제로 이렇게 보입니다:

---
title: My Note Title
date: 2026-03-03
tags:
  - Obsidian
  - Tutorial
---

두 --- 줄 사이의 내용을 YAML frontmatter라고 하며, 데이터 형식입니다. 하지만 직접 작성할 필요는 없습니다—Obsidian의 시각적 편집기가 모든 것을 처리합니다. 속성 패널에서 클릭하고 선택하면 기본 코드가 자동으로 생성됩니다.

그냥 이런 것이 있다는 것만 알아두세요. 일상적인 사용에서는 소스 코드를 건드릴 필요가 없습니다.

Properties는 무엇에 좋을까요?

이렇게 물을 수도 있습니다: 본문에 모든 것을 쓰면 되지, 왜 속성이라는 추가 계층을 두는 걸까요?

세 가지 이점이 있습니다.

1. 더 정확한 검색

일반 검색은 전체 텍스트 검색입니다. ’tutorial’을 검색하면 본문에 ’tutorial’이라는 단어가 포함된 모든 노트가 나타나며, 잠재적으로 방대한 목록이 나올 수 있습니다.

하지만 속성에 categories: Tutorial을 설정하면 Obsidian의 검색 구문을 사용하여 정확하게 필터링할 수 있습니다:

[categories: Tutorial]

이렇게 하면 ‘Tutorial’로 분류된 노트만 반환되며, 본문에서 ’tutorial’이라는 단어를 우연히 언급한 노트는 제외됩니다.

Properties는 구조화된 데이터이고, 본문은 비구조화된 데이터입니다. 노트가 수백 개가 되면 이 차이는 점점 더 중요해집니다.

2. 자동 템플릿 채우기

이 기능은 템플릿과 함께 작동합니다. 템플릿에 대해서는 다음 장에서 자세히 다루겠지만, 여기서 간단히 미리 보겠습니다:

템플릿에 date: {{date}}와 같은 속성을 미리 설정할 수 있습니다. 해당 템플릿에서 새 노트를 만들 때마다 날짜가 자동으로 현재 날짜로 채워집니다. 제목, 카테고리와 같은 반복적인 속성도 마찬가지로 템플릿이 자동으로 채워줍니다.

3. 웹 클리핑 및 가져오기에서 자동 메타데이터

브라우저 클리핑 플러그인(예: Obsidian Web Clipper)을 사용하여 웹 기사를 Obsidian에 저장하면, 클리핑된 노트에 자동으로 속성이 포함됩니다—원본 제목, 링크, 저장 날짜 및 기타 정보가 속성에 저장되어 콘텐츠의 출처를 추적하는 데 도움이 됩니다.

자주 사용되는 Properties

원하는 속성은 무엇이든 만들 수 있지만, 가장 일반적으로 사용되는 몇 가지가 있습니다. 이에 대해 알아두는 것이 좋습니다.

1. title

이름에서 알 수 있듯이 노트의 제목입니다.

참고: title 속성은 파일 이름과 다를 수 있습니다. 파일 이름은 파일 목록에서 보이는 것이고, title 속성은 노트의 ‘공식 제목’입니다.

예를 들어, 2026-03-03 Obsidian-Properties.md라는 파일이 있지만 title 속성은 Obsidian Properties: Make Notes Searchable입니다—파일 이름의 날짜는 정렬을 위한 것이며 제목에 나타날 필요가 없습니다.

개인적인 조언: 특별한 번호 매기기 요구 사항이 없다면 제목과 파일 이름을 동일하게 설정하여 혼동을 피하세요.

2. date

노트의 생성 날짜 또는 발행 날짜를 기록합니다.

수동으로 입력하는 경우 형식은 YYYY-MM-DD입니다(예: 2026-03-03).

하지만 팁이 있습니다: 템플릿에서 date 속성을 설정하는 경우 다음과 같이 작성하는 것이 좋습니다:

date: "{{date}}"

이렇게 하면 템플릿에서 새 노트를 만들 때마다 {{date}}가 노트를 만든 날짜로 자동 대체됩니다. 수동 입력이 필요 없고 실수도 없습니다.

이 기능은 다음 장의 템플릿에서 자세히 다룹니다.

3. aliases

이 속성은 매우 유용합니다—꼭 알아두세요.

별칭을 사용하면 노트에 여러 이름을 부여할 수 있습니다. 우리는 종종 같은 대상을 다른 이름으로 부르는데, 이때 별칭이 유용합니다.

예를 들어, 파일 이름이 ‘The Donald’인 도널드 트럼프에 관한 노트가 있습니다. 하지만 다른 노트에서는 그를 ‘Trump’, ‘Donald Trump’, ‘President Trump’, ‘Mr. Trump’ 등으로 언급할 수 있습니다.

별칭이 없으면 [[Trump]]를 사용하여 링크를 만들 때 Obsidian은 ‘Trump’라는 이름의 노트에 링크하려는 것으로 생각합니다. 하지만 그런 노트는 존재하지 않습니다—노트 이름은 ‘The Donald’입니다. 결과적으로 같은 사람을 가리키지만 링크는 다른 곳을 가리키게 됩니다.

별칭이 있으면 다릅니다. ‘The Donald’ 노트의 속성에 다음과 같이 작성합니다:

aliases:
  - Trump
  - Donald Trump
  - President Trump
  - Mr. Trump

이제 어느 노트에 있든 [[를 입력한 다음 ‘Trump’, ‘Donald Trump’, ‘Mr. Trump’를 입력하면 Obsidian이 ‘The Donald’ 노트에 링크하도록 제안합니다. 여러 이름, 하나의 항목.

이는 지식 베이스를 구축할 때 특히 유용합니다. 많은 개념에 대체 이름, 약어 또는 영어 이름이 있습니다. 별칭을 사용하여 관리하면 링크가 체계적으로 유지됩니다.

4. categories

노트에 ‘Book Notes’, ‘Tutorial’, ‘Random Thoughts’ 등과 같은 광범위한 카테고리를 표시합니다.

categories:
  - Obsidian Tutorial

카테고리는 주로 자신의 참고용으로, 같은 유형의 노트를 빠르게 필터링하는 데 도움이 됩니다. 나중에 노트를 블로그에 게시하면 많은 블로깅 시스템(예: Hugo, Hexo)이 이 속성을 읽어 카테고리 페이지를 생성합니다.

5. tags

태그는 대부분에게 익숙합니다. Obsidian에서는 본문에 #tagname을 사용하여 태그를 추가하거나 속성에 통일하여 작성할 수 있습니다:

tags:
  - Obsidian
  - Tutorial
  - Note-taking

속성에 태그를 작성하면 중앙 집중식 관리의 장점이 있습니다—본문을 검색하지 않고도 노트에 어떤 태그가 있는지 한눈에 알 수 있습니다.

하지만 솔직히 말해서, Obsidian에서 태그의 역할은 링크로 대체될 수 있습니다. 개념이 태그를 붙일 만큼 중요하다면, 그 개념에 대한 노트를 만들고 링크하는 것은 어떨까요? 링크는 더 유연하고 더 많은 내용을 담을 수 있습니다.

물론 태그에 익숙하다면 그대로 사용해도 전혀 문제없습니다. 태그와 링크는 충돌하지 않습니다—자신에게 맞는 것을 선택하세요.

6. 기타 유용한 Properties

위의 다섯 가지 외에도 유용하게 사용할 수 있는 몇 가지를 소개합니다:

cssclasses — 단일 노트에 특별한 CSS 스타일을 지정합니다. 예를 들어, 노트에 다른 글꼴이나 레이아웃을 사용하려면 이 속성을 사용자 정의 CSS와 함께 사용할 수 있습니다. 고급 기능이므로 초보자는 지금은 건너뛰어도 됩니다.

publish — Obsidian의 공식 게시 서비스(Obsidian Publish)를 사용하는 경우 이 속성은 노트의 게시 여부를 제어합니다. true는 게시, false는 게시하지 않음입니다.

description — 노트에 대한 간단한 설명 또는 요약입니다. 블로깅 시스템과 함께 사용하면 이 속성이 종종 기사 목록에서 미리보기 텍스트로 나타납니다.

또한 author, source, status(초안/완료) 등 필요한 속성을 자유롭게 만들 수 있습니다. Properties는 완전히 사용자 정의 가능하므로 유용한 것을 추가하세요.

요약

오늘 배운 내용:

Properties란 무엇인가: 노트 상단의 구조화된 정보입니다. 점 세 개를 클릭하여 추가하며 코딩이 필요 없습니다.
사용하는 이유: 정확한 검색, 자동 템플릿 채우기, 웹 클리핑에서 자동 메타데이터.
자주 사용되는 Properties:
- title — 파일 이름과 다를 수 있습니다.
- date — 템플릿에서 {{date}}를 사용하여 자동 채우기.
- aliases — 같은 노트를 가리키는 여러 이름, 링크에 필수적.
- categories — 노트를 광범위한 카테고리로 그룹화.
- tags — 중앙 집중식 관리, 하지만 링크가 대부분의 사용 사례를 대체할 수 있음.
Properties는 완전히 사용자 정의 가능: 필요한 것을 추가하세요.

핵심 정리:

별칭은 가장 가치 있는 속성입니다—링크 시스템의 훌륭한 동반자입니다.
태그도 작동하지만, Obsidian에서는 링크가 더 강력합니다.
처음부터 너무 많은 속성을 설정하지 마세요; 필요할 때 추가하세요.

Obsidian 키보드 단축키: 근육 기억 만들기

Mon, 01 Jan 0001 00:00:00 +0000

앞서 브라우저 클리핑 플러그인을 다뤘습니다. 웹 콘텐츠를 Obsidian에 한 번의 클릭으로 저장하고, 깔끔한 서식과 자동으로 채워지는 메타데이터까지. 이번 장은 다른 각도에서 접근합니다. 무언가를 집어넣는 방법 대신, Obsidian 자체를 더 효율적으로 사용하는 방법을 알아보겠습니다.

키보드 단축키를 바인딩해야 하는 이유

명령 팔레트(Command Palette)부터 시작해 보죠.

Cmd+P는 Obsidian에서 가장 훌륭한 기능 중 하나입니다. 팔레트를 열고, 원하는 작업을 입력한 후 Enter를 누르면 끝납니다. 버튼이 어디 있는지 기억하거나 메뉴를 뒤질 필요가 없습니다.

하지만 얼마간 사용하다 보면 문제가 생깁니다. 명령어가 너무 많다는 점입니다. Obsidian에는 수십 개의 핵심 명령어가 기본으로 제공되고, 커뮤니티 플러그인을 추가하면 그 수는 쉽게 백 개를 넘깁니다. 명령 팔레트를 열 때마다 “이 명령어 이름이 뭐였지?” 생각하고, 입력하고, 목록이 필터링될 때까지 기다린 후 Enter를 눌러야 합니다.

자주 사용하지 않는 작업이라면 이 워크플로우가 전혀 문제되지 않습니다. 하지만 템플릿 삽입이나 모든 제목 접기처럼 자주 사용하는 작업의 경우, 매번 이 과정을 반복하는 것은 짜증스럽습니다.

키보드 단축키가 이 문제를 해결합니다. 가장 자주 사용하는 작업을 편리한 키에 바인딩하여, 생각할 필요 없이 바로 실행하는 것입니다.

익숙해지면, 이 작업들은 순수한 근육 기억이 됩니다. 생각하기도 전에 손가락이 키를 누르게 됩니다.

키보드 단축키 설정 접근하기

경로: 설정 (Cmd+,) → 왼쪽 사이드바에서 “단축키(Hotkeys)” 찾기.

단축키 페이지에 들어가면 긴 명령어 목록이 보입니다. 각 행은 하나의 명령어이며, 세 개의 열로 구성됩니다.

왼쪽 열: 명령어 이름 (출처 플러그인 포함)
가운데 열: 현재 바인딩된 단축키 (바인딩되지 않았으면 비어 있음)
오른쪽 열: 작업 버튼

검색 및 바인딩

페이지 상단에는 퍼지 검색을 지원하는 검색 상자가 있습니다. 예를 들어 “템플릿 삽입(Insert Template)“을 바인딩하려면 “template"이라고 입력하면 관련 명령어가 즉시 필터링됩니다.

원하는 명령어를 찾은 후:

1단계: 오른쪽의 + 버튼을 클릭합니다.

2단계: 바인딩하려는 키 조합(예: Cmd+T)을 누릅니다. Obsidian이 자동으로 인식하여 표시합니다.

3단계: Enter를 눌러 확인하거나 다른 곳을 클릭하여 닫으면 바인딩이 완료됩니다.

단축키가 더 이상 필요 없으면 오른쪽의 × 버튼을 클릭하여 바인딩을 해제하고 빈 상태로 되돌립니다.

충돌 처리

단축키를 바인딩할 때 가끔 충돌이 발생할 수 있습니다. 바인딩하려는 키를 다른 명령어가 이미 사용하고 있는 경우입니다. Obsidian은 충돌을 강조 표시하고 현재 어떤 명령어가 해당 키를 사용 중인지 알려줍니다.

해결 방법은 간단합니다.

충돌하는 명령어 이름을 확인합니다.
해당 명령어를 검색하여 ×를 클릭해 바인딩을 해제합니다.
다시 돌아가 원하는 명령어를 바인딩하거나, 다른 키 조합을 선택합니다.

작은 주의사항: Obsidian 1.6 이후, 일부 키 조합은 GUI에서 바인딩할 수 없으며 유효하지 않음으로 표시됩니다. 이런 경우 볼트 디렉터리의 .obsidian/hotkeys.json 파일을 직접 편집하여 수동으로 추가할 수 있습니다. 하지만 대부분의 키는 문제가 없으므로 GUI를 사용해도 괜찮습니다.

내가 추천하는 바인딩 목록

모든 명령어에 단축키를 바인딩할 가치가 있는 것은 아닙니다. 기준은 간단합니다. 사용 빈도가 높고 + 여러 단계를 거쳐야 하는 작업입니다. 가끔 사용하는 명령어는 Cmd+P로 검색하면 되므로, 굳이 키를 기억할 필요가 없습니다.

다음은 제가 직접 사용하는 목록입니다.

명령어	기본 단축키	추천 바인딩	설명
Insert Template	없음	Cmd+T	가장 자주 사용하는 작업 중 하나, 필수 바인딩
Toggle Reading/Edit Mode	Cmd+E	기본값 사용	기본값이 이미 편리하므로 변경 불필요
Collapse All Headings	없음	Cmd+[	노트 구조가 길 때 사용
Expand All Headings	없음	Cmd+]	위와 함께 사용
Toggle Left Sidebar	없음	Cmd+\	글쓰기에 집중할 때 사이드바 숨기기
New Note	Cmd+N	기본값 사용	기본값으로 충분
Open Quick Switcher	Cmd+O	기본값 사용	다른 노트로 빠르게 이동

Templater 플러그인을 설치했다면 (핵심 템플릿 플러그인보다 더 강력하며, 별도로 다룰 예정), 이 플러그인에도 자체 명령어인 “Templater: Open Insert Template Modal"이 있습니다. 이 명령어에도 단축키를 바인딩하는 것을 추천합니다.

한 번에 모두 바인딩하지 않는 것을 권장합니다. 가장 자주 사용하는 두세 개부터 시작하고, 익숙해지면 추가하세요. 너무 많은 키를 바인딩하면 기억하기 어려워 혼란스러울 수 있습니다.

요약

오늘 배운 내용:

단축키 설정 진입: 설정 (Cmd+,) → 단축키(Hotkeys), 여기서 모든 단축키 관리
바인딩 방법: 명령어 이름 검색 → + 클릭 → 키 조합 누르기 → 확인
바인딩 해제: × 클릭, 단축키가 빈 상태로 돌아감
충돌 처리: Obsidian이 충돌을 강조 표시, 기존 바인딩을 먼저 해제한 후 재할당

핵심 포인트:

사용 빈도가 높고 + 여러 단계가 필요한 작업만 바인딩, 자주 사용하지 않는 명령어는 Cmd+P로 충분
가장 흔한 두세 개부터 시작, 익숙해지면 점차 확장, 한 번에 너무 많이 바인딩하지 말 것
우선 순위: Insert Template (Cmd+T), Collapse/Expand All Headings (Cmd+[/]), Toggle Left Sidebar (Cmd+)

Obsidian 테마: 5분 만에 외관 바꾸기

Mon, 01 Jan 0001 00:00:00 +0000

지금까지 그림, 플로우차트, 마인드맵을 위한 Excalidraw를 다뤘습니다. 실용적인 내용이 많았죠. 이번 장은 좀 더 가볍게, Obsidian의 외관을 멋지게 바꾸는 테마 변경에 대해 알아보겠습니다.

지난 몇 장은 내용이 꽤 빡빡했으니, 이번에는 쉬어가는 코너라고 생각하세요. 테마 설정은 간단하지만, 예쁜 인터페이스는 앱을 열고 글을 쓰고 싶게 만드는 데 확실히 도움이 되기 때문에 별도 장으로 다룰 가치가 있습니다.

이 장에서는 세 가지를 다룹니다:

Obsidian 내장 마켓플레이스를 통해 테마 설치하기
GitHub에서 수동으로 테마 설치하기 (고급, 거의 필요 없음)
개인 추천: Nord 테마

테마란 무엇이며 왜 바꾸나요?

Obsidian의 기본 인터페이스는… 뭐랄까, 밋밋합니다. 기능적으로는 문제없지만, 시각적으로는 “작동은 한다"는 느낌 이상은 아닙니다.

테마를 바꾸면 완전히 다른 경험이 됩니다. 어떤 테마는 미니멀하고 깔끔하고, 어떤 테마는 정보 밀도가 높아 많은 노트를 정리하기 좋고, 어떤 테마는 어둡고 장시간 사용해도 눈이 편합니다. 색 구성, 글꼴 스타일, 사이드바 레이아웃 등 모든 것이 바뀝니다.

테마는 단지 “예뻐 보이기” 위한 것만이 아닙니다. 매일 앱을 열 때 인터페이스가 기분 좋으면 무의식적인 저항이 확 줄어듭니다. 노트 작성을 습관화하는 데 있어 도구의 “느낌"과 “미학"은 정말 중요합니다.

따라서 마음에 드는 테마를 고르는 데 30분 정도 투자하는 것은 충분히 가치 있습니다.

내장 마켓플레이스를 통해 테마 설치하기

가장 간단한 방법입니다. 마켓플레이스에는 수백 개의 커뮤니티 테마가 있으며, 모두 무료이고 원클릭으로 설치할 수 있습니다.

경로: 설정 → 외관 → 테마 → 찾아보기

들어가면 목록이 보입니다. 다운로드 수로 정렬하거나 특정 테마 이름을 검색할 수 있습니다. 마음에 드는 테마를 찾아 클릭하고, “설치 및 사용"을 클릭하면 테마가 전환됩니다. 정말 간단합니다. 추가 단계는 없습니다.

단계 요약:

설정 열기
왼쪽에서 “외관” 클릭
“테마” 섹션에서 “찾아보기” 클릭
검색하거나 둘러보며 마음에 드는 테마 찾기
“설치 및 사용” 클릭

기본 테마로 돌아가고 싶다면 같은 방법으로 테마를 “기본"으로 변경하면 됩니다.

GitHub에서 수동으로 테마 설치하기

이 방법은 대부분의 사람에게 필요하지 않지만, 혹시 마켓플레이스에 없고 GitHub에만 있는 테마를 만날 경우를 대비해 간단히 설명드리겠습니다.

수동 설치 단계:

해당 GitHub 저장소로 이동하여 테마 파일을 다운로드합니다 (보통 theme.css와 manifest.json이 들어 있는 폴더)
전체 폴더를 보관소의 .obsidian/themes/ 디렉터리에 넣습니다
Obsidian을 다시 시작합니다
그런 다음 설정 → 외관 → 테마로 가면 새로 설치된 테마가 보입니다

참고: .obsidian 폴더는 기본적으로 숨겨져 있습니다. Mac에서는 Command + Shift + .를 눌러 숨김 파일을 표시할 수 있습니다.

다시 말하지만: 대부분의 사람은 이 방법을 사용할 일이 없습니다. 내장 마켓플레이스에 이미 수백 개의 테마가 있어 일상적으로 사용하기에 충분합니다. 그냥 이런 방법도 있다는 정도만 알아두세요.

내 선택: Nord 테마

설치 방법을 다뤘으니, 이제 제 개인적인 선택을 소개하겠습니다. 바로 Obsidian Nord입니다. 제가 가장 오래 사용한 테마로, 설치한 이후로 거의 바꾸지 않았습니다.

Nord의 색상 팔레트는 “Nord 색상 시스템"에서 비롯되었으며, 북극 오로라와 극지방의 얼음과 눈에서 영감을 받았습니다. 차가운 톤의 짙은 파란색 계열입니다. 화려하거나 자극적이지 않으면서도 매우 안정적이고 오래 봐도 질리지 않는 색상입니다.

제가 선택한 이유:

어둡고 눈에 편함: 장시간 사용해도 편안합니다. 자극적인 순수 검정이 아니라 청회색이 섞인 깊은 색감입니다
부드러운 색 구성: 강조 색상, 링크 색상, 제목 색상 모두 절제되어 있어 인터페이스가 산만해 보이지 않습니다
시간이 지나도 질리지 않음: 2년째 사용 중인데, Obsidian을 열 때마다 여전히 보기 좋고 바꾸고 싶은 마음이 들지 않습니다

설치: 테마 마켓플레이스에서 **“Obsidian Nord”**를 검색한 후 설치 및 활성화하면 됩니다.

요약

오늘 배운 내용:

테마 변경 진입점: 설정 → 외관 → 테마 → 찾아보기
내장 마켓플레이스에는 수백 개의 무료 테마가 있으니 마음에 드는 것을 찾아 바로 설치/활성화
어두운/밝은 모드는 설정 → 외관 → 기본 색 구성에서 전환 가능
마켓플레이스에 없는 드문 테마는 GitHub에서 수동 다운로드하여 .obsidian/themes/ 폴더에 넣기
추천 테마: Obsidian Nord

핵심 포인트:

일상 사용에는 내장 마켓플레이스로 충분합니다. 간단하고 편리합니다
예쁜 인터페이스는 매일 노트를 열 때의 심리적 저항을 줄여줍니다. 신중히 고르는 것이 좋습니다
Nord는 제가 2년째 사용하는 테마로, 어둡고 차가운 톤을 선호하는 분께 좋습니다

Obsidian 템플릿: 재사용 가능한 형식으로 더 빠르게 작성하기

Mon, 01 Jan 0001 00:00:00 +0000

우리는 노트 속성(각 노트에 제목, 날짜, 카테고리 추가)에 대해 다뤘습니다. 하지만 곧 문제를 발견하게 됩니다: 새 노트를 만들 때마다 이러한 속성을 수동으로 입력하고 형식을 다시 설정해야 한다는 점입니다. 템플릿은 이러한 반복 작업을 해결하기 위해 설계되었습니다.

템플릿이 왜 필요한가요?

여러분은 이렇게 생각할 수도 있습니다: 속성 몇 줄을 수동으로 채우는 것이 그리 큰 일이 아니라고요. 하지만 계산해 봅시다. 모든 블로그 글에는 제목, 날짜, 카테고리가 필요합니다. 모든 책 노트에는 저자, 출판사, 나의 평점도 필요하죠. 한두 개 노트는 괜찮습니다. 하지만 수십, 수백 개의 노트가 있을 때마다 매번 이 고정된 필드를 처음부터 입력해야 한다면 짜증이 납니다. 더 중요한 것은, 수동 입력은 오류가 발생하기 쉽다는 점입니다—잘못된 날짜 형식, 일관성 없는 카테고리 이름은 나중에 검색 결과가 일치하지 않는 문제로 이어집니다.

템플릿이 이 문제를 해결합니다: 노트 형식을 미리 작성해 저장하고, 필요할 때 한 번 클릭으로 적용하세요—수동 입력이 필요 없습니다.

1단계: 템플릿 핵심 플러그인 활성화

템플릿은 Obsidian의 핵심 플러그인입니다. 기본적으로 활성화되어 있지 않으므로 수동으로 켜야 합니다. 설정 → 핵심 플러그인으로 이동 → ‘템플릿’을 찾아 오른쪽의 스위치를 켜세요.

활성화하면 핵심 플러그인 목록에서 ‘템플릿’ 행 오른쪽에 작은 톱니바퀴 아이콘이 나타납니다. 클릭하여 설정합니다.

2단계: 템플릿 폴더 위치 설정

템플릿 플러그인 설정을 엽니다. 가장 중요한 설정은 템플릿 폴더 위치입니다. 템플릿 파일을 저장할 폴더 이름을 입력하세요. 예를 들어, 제 보관소에서는 02-Templates라는 폴더를 사용하므로 그렇게 입력합니다. 이 폴더 안의 모든 파일이 템플릿으로 인식됩니다. 템플릿을 호출하면 Obsidian이 이 폴더의 모든 파일을 목록으로 보여줍니다.

아직 이 폴더가 없다면 먼저 만든 후, 다시 돌아와 경로를 입력하세요.

3단계: 첫 번째 템플릿 만들기

템플릿 파일 만들기

지정한 템플릿 폴더(예: 02-Templates)에서 새 파일을 만드세요—단축키 Cmd+N을 사용하거나 폴더를 마우스 오른쪽 버튼으로 클릭하고 ‘새 파일’을 선택하세요. 이 파일은 일반 노트와 완전히 동일합니다. 평소처럼 내용을 작성하면 됩니다. 저장하면 템플릿이 됩니다.

템플릿 변수

템플릿에서 가장 중요한 부분은 변수입니다. 앞서 언급했듯이 속성에 {{date}}를 작성하면 날짜가 자동으로 채워집니다. 세 가지 내장 변수를 자세히 살펴보겠습니다:

변수	설명	예시
`{{date}}`	템플릿이 삽입된 날짜	2026-03-04
`{{time}}`	템플릿이 삽입된 시간	14:30
`{{title}}`	현재 노트의 파일 이름	My Book Note

{{date}}에 집중하세요.

이 변수는 동적입니다—템플릿을 사용할 때마다 현재 날짜로 대체됩니다. 두 가지 접근 방식을 비교해 보세요:

date: 2026-03-04 (하드코딩) → 이 템플릿으로 만든 모든 노트의 날짜는 영원히 2026-03-04입니다.
date: {{date}} → 오늘 사용하면 오늘 날짜가, 내일 사용하면 내일 날짜가 채워집니다.

따라서 날짜 속성에는 하드코딩 대신 항상 {{date}}를 사용하세요. 이것이 앞서 암시한 팁입니다.

4단계: 템플릿 사용하기

노트를 만든 후 템플릿 삽입하기

먼저 새 노트를 만든 다음 템플릿을 삽입하세요.

빈 노트를 만든 후 템플릿을 삽입하는 방법은 두 가지입니다:

방법 1: 명령 팔레트 (권장)

Cmd+P를 눌러 명령 팔레트를 열고 ‘템플릿 삽입’을 입력한 후 Enter를 누르고 목록에서 원하는 템플릿을 선택하세요.

방법 2: 사이드바 버튼

설정에서 템플릿 버튼을 활성화했다면 왼쪽 도구 모음에 템플릿 아이콘이 나타납니다. 클릭하여 템플릿을 직접 선택하세요.

두 방법 모두 작동합니다. 더 편한 방법을 사용하세요. 명령 팔레트의 장점은 버튼 위치를 기억할 필요 없이 Cmd+P를 누르고 검색하면 된다는 점입니다.

실용적인 템플릿 예제

이제 이론을 다뤘으니 실제 템플릿을 살펴보겠습니다.

블로그 게시물 템플릿 (이 책의 형식과 일치):

---
title: {{title}}
date: {{date}}
categories:
  -
---

책 노트 템플릿:

---
title: {{title}}
date: {{date}}
categories:
  - Reading Notes
---
Publisher:
Date finished: {{date}}

# Core Ideas

# Memorable Passages

# My Review

일기 템플릿:

---
date: {{date}}
---

## What I Did Today

## Problems I Ran Into

## Plan for Tomorrow

이 세 가지 템플릿은 가장 일반적인 시나리오를 다룹니다. 바로 사용하거나 원하는 대로 수정할 수 있습니다. 자주 사용하는 몇 가지로 시작하고, 반복되는 형식을 만나면 새 템플릿을 추가하세요. 처음부터 모든 가능한 경우를 생각하려 하지 마세요—지나친 고민은 결국 템플릿을 전혀 사용하지 않게 만들 수 있습니다.

요약

오늘 배운 내용:

‘템플릿’ 핵심 플러그인 활성화 (설정 → 핵심 플러그인 → 켜기)
템플릿 폴더 설정 (이 폴더의 모든 파일이 템플릿으로 인식됨)
세 가지 내장 변수: {{date}} / {{time}} / {{title}}
템플릿 삽입: Cmd+P, ‘템플릿 삽입’ 검색, 원하는 템플릿 선택

핵심 요점:

날짜 속성에는 하드코딩 대신 {{date}}를 사용하세요—템플릿을 사용할 때마다 현재 날짜가 자동으로 채워집니다.
템플릿은 일반 노트와 동일합니다—지정된 폴더에 넣기만 하면 되며, 특별한 설정이 필요 없습니다.
자주 사용하는 몇 가지 템플릿으로 시작하여 필요에 맞게 충분히 사용하세요—과도하게 설계하지 마세요.

Obsidian 플러그인: 진정한 확장의 세계

Mon, 01 Jan 0001 00:00:00 +0000

지금까지 Obsidian의 기본 기능인 볼트 생성, 노트 작성, 양방향 링크 사용, 이미지 삽입 등을 다뤘습니다. 이제 Obsidian에서 가장 흥미로운 부분인 플러그인에 대해 알아보겠습니다.

플러그인이란?

플러그인은 Obsidian의 기능을 확장하는 추가 기능입니다. Obsidian 자체는 깔끔한 노트 작성 환경을 제공하지만, 플러그인을 설치하면 캘린더, 칸반 보드, AI 어시스턴트 등 원하는 거의 모든 기능을 추가할 수 있습니다.

Obsidian 플러그인은 핵심 플러그인과 서드파티 플러그인(커뮤니티 플러그인이라고도 함) 두 가지 유형이 있습니다.

핵심 플러그인

핵심 플러그인은 Obsidian에 기본 내장되어 있습니다. 설정 → 핵심 플러그인으로 이동하면 목록을 볼 수 있습니다.

이들은 Obsidian 팀이 개발한 것으로, 예를 들면 다음과 같습니다.

검색: 노트 내용을 전체 검색
그래프 보기: 노트 간 연결 관계 시각화
데일리 노트: 자동으로 일일 노트 생성
개요: 제목 수준에 기반한 목차 생성

일부 핵심 플러그인은 기본 활성화되어 있고, 그렇지 않은 것도 있습니다. 필요에 따라 켜거나 끌 수 있습니다.

특징: 공식 유지보수, 안정적이고 안전하지만 개수가 제한적입니다.

서드파티 플러그인 (커뮤니티 플러그인)

서드파티 플러그인은 전 세계 개발자들이 기여합니다. 생각할 수 있는 거의 모든 기능이 이미 누군가에 의해 만들어져 있습니다.

특징: 매우 다양하고 기능이 풍부하며 커뮤니티 개발자가 유지보수합니다.

핵심 플러그인으로 원하는 작업을 할 수 없다면, 커뮤니티 플러그인 마켓에서 해결책을 찾을 가능성이 높습니다.

서드파티 플러그인 설치 방법

두 가지 방법이 있습니다.

방법 1: 커뮤니티 플러그인 마켓에서 설치 (권장)

가장 쉬운 방법으로, 세 단계만 거치면 됩니다.

1단계: 제한 모드 해제

설정 → 서드파티 플러그인으로 이동합니다. ‘안전 모드’가 활성화되어 있습니다. ‘해제’를 클릭하고 확인합니다.

Obsidian은 보안을 위해 기본적으로 제한 모드를 활성화합니다. 서드파티 플러그인은 다른 사람이 작성한 코드이기 때문입니다. 하지만 커뮤니티 마켓의 플러그인은 공식 팀의 검토를 거쳤으므로 안전하게 사용할 수 있습니다.

2단계: 검색 및 설치

제한 모드를 해제한 후 ‘찾아보기’ 버튼을 클릭하여 커뮤니티 플러그인 마켓을 엽니다. 원하는 플러그인을 검색하고 찾은 후 ‘설치’를 클릭합니다.

3단계: 활성화

설치 후 플러그인이 자동으로 활성화되지는 않습니다. 설정 → 서드파티 플러그인으로 돌아가서 방금 설치한 플러그인을 찾아 스위치를 켜세요.

일부 플러그인은 활성화 후 바로 작동하지만, 설정이 필요한 플러그인도 있습니다. 옆에 톱니바퀴 아이콘이 있는 플러그인은 설정할 수 있습니다. 클릭하면 옵션을 볼 수 있습니다.

방법 2: 수동 설치 (GitHub에서 다운로드)

일부 플러그인은 아직 커뮤니티 마켓에 등록되지 않았거나(검토 중), 최신 개발 버전을 사용하고 싶을 수 있습니다. 이런 경우 수동으로 설치해야 합니다. 이 방법은 일반적으로 초보자에게 권장되지 않지만, 알아두면 좋습니다.

1단계: 플러그인 파일 다운로드

플러그인의 GitHub 페이지로 이동하여 Releases 섹션을 찾고 최신 버전을 다운로드합니다. 일반적으로 다음 세 파일이 필요합니다.

main.js
manifest.json
styles.css (일부 플러그인에는 없으며, 없으면 무시)

2단계: 플러그인 폴더에 배치

볼트 폴더에서 .obsidian/plugins/ 디렉토리를 찾습니다(없으면 생성). 그 안에 폴더를 만들고 다운로드한 파일을 넣습니다.

Your Vault/
├── .obsidian/
│   └── plugins/
│       └── plugin-name/
│           ├── main.js
│           ├── manifest.json
│           └── styles.css

.obsidian은 숨김 폴더입니다. Mac에서는 Cmd + Shift + .를 눌러 숨김 파일을 표시합니다. Windows에서는 폴더 옵션에서 ‘숨김 파일 표시’를 체크합니다.

이미 서드파티 플러그인을 설치했다면, 이미지에 표시된 버튼을 클릭하여 이 폴더를 열 수 있습니다.

3단계: 활성화

Obsidian으로 돌아가서 설정 → 서드파티 플러그인으로 이동하여 목록을 새로고침하면 방금 넣은 플러그인이 나타납니다. 스위치를 켜서 활성화합니다.

보통 방법 1이면 충분합니다. 방법 2는 고급 사용자나 최신 기능을 시도해보고 싶은 분들을 위한 것입니다.

플러그인 기능 사용 방법

플러그인을 설치하고 활성화한 후, 어떻게 기능에 접근할까요? 두 가지 방법이 있습니다.

방법 1: 왼쪽 사이드바 단축 버튼

Obsidian 맨 왼쪽에 있는 세로로 작은 아이콘들은 다양한 기능의 단축 항목입니다.

많은 플러그인이 설치 후 여기에 아이콘을 추가합니다. 클릭하면 해당 기능이 열립니다. 예를 들어, Recent Files 플러그인을 설치하면 시계 아이콘이 나타나며, 클릭하면 최근 편집한 파일 목록이 표시됩니다.

방법 2: 명령 팔레트 (권장)

Ctrl/Cmd + P를 눌러 명령 팔레트를 열고, 수행하려는 작업을 입력한 후 Enter를 누릅니다.

거의 모든 플러그인 기능은 명령 팔레트를 통해 접근할 수 있습니다. 기능이 어디 있는지 기억나지 않나요? 그냥 Ctrl/Cmd + P를 누르고 검색하세요. 예를 들어, 사용하지 않는 이미지를 정리하려면 버튼을 찾을 필요 없이 명령 팔레트에 ‘Clear’를 입력하면 해당 작업을 찾을 수 있습니다.

명령 팔레트는 Obsidian의 범용 진입점입니다. Ctrl/Cmd + P만 기억하세요.

초보자를 위한 필수 플러그인 4가지

Obsidian 플러그인 라이브러리는 방대하지만, 처음부터 많이 설치할 필요는 없습니다. 제가 개인적으로 항상 사용하는 네 가지 플러그인을 소개합니다. 각각 실제 불편을 해결해줍니다.

1. Recent Files — 최근 파일 목록

Obsidian은 기본적으로 ‘최근 파일’ 목록이 없습니다. 노트가 많아지면 방금 편집한 파일을 찾기 위해 폴더를 뒤져야 합니다.

설치 후: 왼쪽 사이드바에 새 패널이 나타나며, 최근에 연 파일을 시간순으로 나열합니다. 클릭하면 해당 파일로 이동합니다.

2. Easy Typing — 자동 서식

Notion, Word 등 다른 플랫폼에서 넘어온 사용자는 Markdown 문법에 익숙하지 않을 수 있습니다. 한글과 영어를 혼용할 때 서식이 일관되지 않을 수 있고, 수동으로 공백을 추가하는 것은 번거롭습니다. 표 작성, 색상 강조 등 Markdown 작업은 복잡한 문법을 요구합니다.

하지만 이 플러그인은 Word를 사용해본 사람이라면 익숙할 것입니다.

설치 후:

한글과 영어 텍스트 사이에 자동으로 공백 추가 — ‘我用Obsidian’을 입력하면 ‘我用 Obsidian’이 되어 가독성이 즉시 향상됩니다.
편집 기능 향상 — 텍스트를 선택하고 기호 키(예: *)를 누르면 빠르게 감싸져서 별표 두 개를 수동으로 입력하지 않고도 굵게 표시할 수 있습니다.
스마트 전각 기호 변환 — 코드 환경에서 전각 문장 부호를 반각으로 자동 변환하여 입력기를 전환할 필요가 없습니다.

이 플러그인은 많은 옵션이 있으며, 필요에 따라 활성화할 수 있습니다.

3. Clear Unused Images — 사용하지 않는 이미지 정리

노트를 작성할 때 자주 스크린샷을 찍고 이미지를 삽입합니다. 하지만 때로는 섹션을 삭제하면 그 이미지들은 ‘고아’가 됩니다. 더 이상 어떤 노트도 참조하지 않지만 이미지 파일은 여전히 공간을 차지합니다. 시간이 지나면 첨부 파일 폴더가 정크 이미지로 가득 차게 됩니다.

설치 후: 한 번 실행하면 전체 볼트를 스캔하여 어떤 노트에서도 참조되지 않은 모든 이미지를 찾아 정리해줍니다.

사용 방법: 왼쪽 사이드바의 단축 버튼을 클릭하거나 Ctrl/Cmd + P를 눌러 명령 팔레트를 열고 ‘Clear Unused Images’를 입력한 후 Enter를 누릅니다.

4. Open In New Tab — 새 탭에서 파일 열기

Obsidian의 기본 동작: 파일 목록에서 파일을 클릭하면 현재 탭을 대체합니다. A를 편집 중인데 B를 확인하려고 B를 클릭하면 A가 사라집니다. 다시 돌아가서 찾아야 합니다.

설치 후: 파일 목록에서 파일을 클릭하면 현재 내용을 덮어쓰지 않고 새 탭에서 열립니다. 브라우저와 같은 논리입니다. 파일이 이미 열려 있으면 중복으로 열지 않고 기존 탭으로 자동 이동합니다.

설치 후 바로 작동하며, 설정이 필요 없습니다.

요약

오늘 배운 내용:

두 가지 플러그인 유형: 핵심 플러그인(내장)과 서드파티 플러그인(커뮤니티 기여)
두 가지 설치 방법: 커뮤니티 마켓에서 직접 설치(권장) 또는 GitHub에서 수동 설치
두 가지 사용 방법: 왼쪽 사이드바 단축 버튼 또는 명령 팔레트 Ctrl/Cmd + P (권장)
네 가지 필수 플러그인:
- Recent Files — 최근 편집한 파일 빠르게 찾기
- Easy Typing — 편집 기능 향상
- Clear Unused Images — 참조되지 않은 이미지 정리
- Open In New Tab — 새 탭에서 파일 열기

핵심 정리:

플러그인이 많다고 항상 좋은 것은 아닙니다. 필요한 것만 설치하세요
이 네 가지로 시작하고, 필요에 따라 더 추가하세요
Ctrl/Cmd + P를 기억하세요. Obsidian의 범용 진입점입니다

Obsidian에서 Excalidraw: 손으로 그린 다이어그램을 노트에

Mon, 01 Jan 0001 00:00:00 +0000

앞서 언급했듯이, Canvas 파일은 .canvas 형식이며 .md 파일과 별도로 존재합니다. 즉, 독립적으로 관리해야 하고 같은 파일에 노트와 결합할 수 없습니다. 이 장에서는 이 문제를 해결하는 도구인 Excalidraw 플러그인을 소개합니다.

Excalidraw란 무엇이며 Canvas와 어떻게 다른가?

Excalidraw란?

Excalidraw는 무료 오픈소스 온라인 드로잉 도구로, 독립형 웹 버전(excalidraw.com)이 있어 회원가입 없이 브라우저에서 바로 사용할 수 있습니다. 손글씨 스타일은 순서도, 마인드맵, 아키텍처 다이어그램 등에 완벽합니다.

Obsidian에서는 서드파티 플러그인 버전을 사용합니다. Obsidian 공식이 아닌 커뮤니티 개발자가 유지 관리하므로 수동으로 설치해야 합니다. 핵심 기능은 웹 버전과 동일하지만 Obsidian과의 추가적인 깊은 통합이 있습니다.

Canvas와의 차이점

둘 다 “캔버스에 그림을 그린다"는 점은 같지만, 파일 형식이 완전히 다릅니다. 이것이 핵심 차이입니다.

Canvas: .canvas 파일을 생성합니다. 이는 독립적인 JSON 파일로, .md 노트와 별도로 존재하며 독립적으로 관리해야 합니다.
Excalidraw: 드로잉 데이터를 압축하여 .md 파일 끝에 포함시킬 수 있습니다. 하나의 파일에 텍스트와 그림이 공존하므로 별도 관리가 필요 없습니다.

아래 두 스크린샷은 같은 파일입니다.

이것이 제가 Excalidraw를 추천하는 이유입니다. 파일을 열면 텍스트가 보이고, 전환하면 그림이 보입니다. 두 가지 콘텐츠가 한 곳에 있습니다.

Excalidraw 플러그인 설치

Excalidraw는 서드파티 플러그인이므로 수동으로 설치해야 합니다.

경로: 설정 → 서드파티 플러그인 → 커뮤니티 플러그인 → “Excalidraw” 검색 → 설치 → 활성화

설치 후 플러그인을 활성화하면 왼쪽 사이드바에 Excalidraw 아이콘이 나타납니다.

Excalidraw 생성 및 사용

새 파일 생성 방법

두 가지 방법이 있습니다.

명령어 팔레트: Cmd+P(Mac) 또는 Ctrl+P(Windows), “Excalidraw: 새 그림” 검색 후 Enter.
왼쪽 사이드바: Excalidraw 아이콘을 클릭하여 바로 새로 만듭니다.

기본적으로 새 파일은 .excalidraw(.md 아님)로 생성됩니다. 걱정하지 마세요. 이 파일을 .md 파일의 일부로 만드는 방법이 바로 뒤에 나오는 “투인원” 섹션의 핵심입니다.

일반적인 작업 및 단축키

Excalidraw 도구 모음에서 각 도구 아래에 숫자가 표시됩니다. 이것이 단축키입니다. 숫자를 누르면 도구 모음을 클릭하지 않고도 도구를 바로 전환할 수 있습니다.

도구	단축키
선택	1
사각형	2
다이아몬드	3
타원	4
화살표	5
선	6
자유곡선	7
텍스트	8
지우개	0
캔버스 이동	Space + 드래그, 또는 마우스 가운데 버튼 드래그
캔버스 확대/축소	Ctrl/Cmd + 마우스 휠
화면에 맞추기	Shift+1
모두 선택	Ctrl/Cmd + A
실행 취소	Ctrl/Cmd + Z

Canvas와 비교하여 추가 기능: Excalidraw에는 전용 자유곡선 도구(단축키 7)가 있어 마우스나 트랙패드로 자유롭게 그릴 수 있습니다. Canvas는 이 기능이 없습니다.

키보드 워크플로: 키보드에서 손을 떼지 않고 그리기

Excalidraw는 순수 키보드 워크플로도 지원하므로 노드를 빠르게 만들고 연결하고 내용을 작성하는 데 좋습니다.

기본 탐색(선택 모드):

동작	단축키
다음/이전 요소 선택	Tab / Shift+Tab
선택한 요소 이동	← → ↑ ↓
텍스트 편집 시작	Enter(텍스트 요소가 선택된 상태)
편집 종료, 선택 모드로 돌아가기	Esc
선택한 요소 복제	Ctrl/Cmd + D
선택한 요소 삭제	Backspace 또는 Delete
모두 선택	Ctrl/Cmd + A

캔버스에 콘텐츠 추가

도형 및 텍스트: 도구 모음에서 도형을 선택하고 캔버스를 클릭하여 그립니다. 텍스트 도구로 클릭하고 입력을 시작하면 한글도 지원됩니다.

화살표 연결: 사각형이 선택된 상태에서 가장자리에 마우스를 올리면 녹색 연결점이 나타납니다. 이 점 중 하나에서 다른 도형으로 화살표를 끌어다 놓으면 자동으로 연결됩니다.

기존 노트: Obsidian 파일 트리에서 노트를 Excalidraw 캔버스로 직접 드래그하면 노트 미리보기 카드로 포함됩니다.

이미지: 이미지 파일을 캔버스로 드래그하면 바로 표시됩니다.

핵심 포인트! AI로 Excalidraw 그리기

앞서 “AI로 Canvas 그리기” 섹션과 유사하게, Excalidraw도 Claude Code로 직접 생성할 수 있습니다.

배경

이전에 Claude Code와 Skill 시스템을 소개했습니다. Canvas는 json-canvas Skill을 사용하고, Excalidraw에도 전용 Skill인 **excalidraw-diagram**이 있습니다. 물론 Excalidraw 관련 MCP와 Skill도 많으니 필요에 따라 선택하면 됩니다.

이 Skill은 axtonliu가 만들었고 GitHub에 오픈소스로 공개되었습니다.

https://github.com/axtonliu/axton-obsidian-visual-skills/tree/main/excalidraw-diagram

다운로드 후 다른 Skill과 마찬가지로 ~/.claude/skills/ 디렉토리에 넣습니다.

이 Skill은 독립형 .excalidraw 파일을 생성하므로, 그림만 필요하고 노트 텍스트와 섞고 싶지 않은 경우에 적합합니다.

그림을 .md 파일 안에 직접 포함시키려면(뒤에서 설명할 투인원 형식), 제가 확장 Skill인 obsidian-excalidraw를 작성했습니다. 이 Skill은 결과를 압축하여 .md 파일 끝에 포함시키며, 추가 파일을 만들지 않습니다. 두 Skill은 용도가 다르니 필요에 따라 선택하세요.

사용 방법

Claude Code에서 /excalidraw-diagram을 입력하고 이 Skill을 선택한 후 Tab을 누르고 그리고 싶은 내용을 설명합니다. Claude Code가 해당 Excalidraw 파일을 생성합니다.

라이브 데모

이 장의 내용을 데모로 사용했습니다. Claude Code에게 “이 Excalidraw 내용의 장 구조를 보여주는 순서도를 그리고, 각 섹션 간의 관계를 표시해줘"라고 말했습니다.

Claude Code가 내용을 읽고 자동으로 구조도를 생성하여 .md 파일 끝에 바로 포함시켰습니다. Excalidraw 모드로 전환하면 볼 수 있습니다. 노드를 수동으로 드래그하거나 선을 연결할 필요가 없어 손으로 그리는 것보다 훨씬 빠릅니다.

핵심 포인트! Excalidraw를 .md 파일에 포함시키기(투인원)

분명히 말씀드리자면, 기본적으로 Excalidraw 플러그인은 .excalidraw 파일을 생성하며, 이는 .md 파일과 별개로 Canvas와 마찬가지로 독립적으로 관리해야 합니다.

“투인원” 기능은 기본 동작이 아니며 추가 설정이 필요합니다. 설정하면 새 파일이 .md 형식으로 생성되고, 그림 데이터가 압축되어 파일 끝에 저장되므로 같은 파일에 두 가지가 공존합니다.

Canvas는 이 기능을 제공하지 않지만 Excalidraw는 가능합니다. 설정 후 동일한 .md 파일이 일반 노트이자 그림판 역할을 하여 하나의 파일로 모든 것을 처리할 수 있습니다. 이것이 이 글에서 가장 가치 있는 부분입니다.

아래에서 5단계로 설명합니다.

5.1 두 가지 핵심 속성

세심한 독자라면 앞서 제 노트 스크린샷에서 이미 이 두 가지 머리말 속성을 보셨을 것입니다.

excalidraw-plugin: parsed
excalidraw-open-md: true

excalidraw-plugin: parsed: Excalidraw 플러그인에게 이 .md 파일에 파싱해야 할 Excalidraw 데이터가 있음을 알립니다. 이 속성이 없으면 플러그인이 파일을 처리하지 않습니다.

excalidraw-open-md: true: 파일을 기본적으로 Markdown 모드로 엽니다(그림 모드로 바로 진입하지 않음). true로 설정하면 파일을 열 때 먼저 텍스트가 보이고, 그림이 필요할 때 수동으로 전환합니다. 이 속성이 없으면 파일을 열 때마다 바로 그림판으로 이동하므로 텍스트를 읽으려면 다시 전환해야 해서 불편합니다.

이 두 속성이 머리말에 있으면 파일이 “이중 모드” 기능을 갖게 됩니다.

5.2 템플릿 파일 생성

투인원 설정의 핵심은 이 구성을 템플릿 파일에 저장하는 것입니다. 그러면 새 노트를 만들 때마다 자동으로 포함되므로 매번 수동으로 추가할 필요가 없습니다.

단계:

템플릿 폴더(예: 02 Templates/)에 새 .md 파일을 만들고 이름을 “Excalidraw 템플릿"으로 지정합니다.
다음 내용을 복사하여 붙여넣기하고 저장합니다.

---
excalidraw-plugin: parsed
excalidraw-open-md: true
---

%%
### Drawing
```compressed-json
N4IgLgngDgpiBcIYA8DGBDANgSwCYCd0B3EAGhADcZ8BnbAewDsEAmcm+gV31TkQAswYKDXgB6MSgw4CxAHSp6AWzJJMMJTEZgaCANoBdcuihQAymHRg+oCthhEAQulQBrAOb4ujXAGF6mPT4CCAAxABmkVGqnnhm2ABefIycmJgAvuTh2Oq68MDp6UA
```
%%

이것은 빈 캔버스가 있는 Excalidraw 템플릿입니다. 두 머리말 속성(excalidraw-plugin: parsed 및 excalidraw-open-md: true)은 플러그인에게 이 파일이 투인원 형식이며 기본적으로 Markdown 모드로 열려야 함을 알립니다. 끝에 있는 compressed-json은 빈 캔버스 데이터입니다.

5.3 Excalidraw 플러그인 설정

템플릿 파일만으로는 충분하지 않습니다. Excalidraw 플러그인에 “템플릿을 어디서 찾을지” 알려주고 파일 관리에 방해가 되는 설정을 비활성화해야 합니다.

경로: 설정 → Excalidraw

수정할 두 가지:

① 템플릿 위치 설정: Excalidraw 설정에서 “템플릿 파일” 옵션을 찾아 템플릿 경로(예: 02 Templates/Excalidraw 템플릿)를 입력합니다. 그러면 이후 Excalidraw로 새 파일을 만들 때마다 자동으로 이 템플릿이 사용되며 excalidraw-open-md: true 속성도 포함됩니다.

② “새 파일 이름에 날짜 추가” 비활성화: 기본적으로 Excalidraw는 새 파일 이름에 생성 날짜를 추가합니다(예: Drawing 2026-03-12). 이렇게 하면 파일 이름이 길어지고 Obsidian의 템플릿 명명 논리와 호환되지 않습니다. 이 옵션을 찾아 끕니다.

5.4 단축키 바인딩

Markdown 모드와 그림 모드 간 전환을 오른쪽 클릭 메뉴로 하면 너무 느립니다. 단축키를 바인딩하여 즉시 전환할 수 있습니다.

경로: 설정 → 단축키 → “Excalidraw” 검색

다음 항목을 찾습니다: “Excalidraw: Excalidraw와 Markdown 모드 간 전환”

Cmd+E(Mac) 또는 Ctrl+E(Windows)에 바인딩합니다. 먼저 이 키 조합이 이미 사용 중인지 확인하세요. Obsidian의 기본 Cmd+E는 기울임꼴입니다. 기울임꼴을 자주 사용한다면 Cmd+Shift+E와 같은 다른 키를 선택하세요.

바인딩 후 투인원 파일에서 Cmd+E를 누르면 “텍스트 보기"와 “그림 보기” 사이를 전환할 수 있어 매우 편리합니다.

5.5 파일 끝의 압축 데이터

설정 후 투인원 파일에 그림 내용을 저장할 때마다 파일 끝에 데이터 블록이 자동으로 생성됩니다.

%%
### Drawing
```compressed-json
N4IgLgngDgpiBcIYA8DGBDANgSwCYCd0B3EAGhADcZ8BnbAewDsEAmcm+gV31TkQ...
```
%%

이 compressed-json 코드 블록은 모든 그림 데이터를 압축한 결과입니다. 좌표, 색상, 텍스트 내용, 연결 관계 등이 모두 이 한 줄의 문자열로 압축됩니다.

세 가지 주의사항:

이 내용을 수동으로 삭제하지 마십시오. 삭제하면 그림 데이터가 사라지고 Excalidraw 모드로 전환하면 빈 캔버스가 표시됩니다.
%%는 Obsidian의 주석 구문입니다. 읽기 모드에서는 이 내용이 숨겨져 표시되지 않으므로 노트의 가독성에 영향을 주지 않습니다.
compressed-json 줄은 완전한 한 줄이어야 합니다. 줄바꿈으로 끊어지면 파일에 오류가 발생하여 열리지 않습니다.

요약

오늘 배운 내용:

Excalidraw = 무료 오픈소스 드로잉 도구: 독립형 웹 버전이 있으며 Obsidian은 서드파티 플러그인 버전을 사용합니다. 손글씨 스타일과 무한 캔버스를 제공합니다.
Canvas와의 핵심 차이점: Canvas는 별도의 .canvas 파일을 생성하여 독립적으로 관리해야 하지만, Excalidraw 그림 데이터는 .md 파일에 압축하여 포함시킬 수 있습니다. 하나의 파일, 두 가지 용도.
설치: 설정 → 서드파티 플러그인 → 커뮤니티 플러그인 → Excalidraw 검색 및 설치.
도구 단축키: 숫자 키 1-8과 0으로 도구 전환, Esc로 편집 종료, Tab으로 요소 간 이동, 화살표 키로 이동. 핵심 리듬: 숫자 키로 도구 + Esc/Tab으로 탐색.
AI 그림 그리기: /obsidian-excalidraw Skill을 사용하면 Claude Code가 포함된 그림을 직접 생성하여 수동으로 노드를 드래그하는 것보다 훨씬 빠릅니다.
투인원 설정: 머리말에 excalidraw-plugin: parsed + excalidraw-open-md: true 추가, 템플릿 파일을 통해 구성, Excalidraw 설정에서 템플릿 경로 설정, Cmd+E에 빠른 모드 전환 단축키 바인딩.
파일 끝 데이터: ## Drawing + compressed-json 코드 블록은 압축된 그림 데이터이며 %%로 감싸져 읽기 모드에서 보이지 않습니다. 수동으로 삭제하지 마십시오.

감사의 말: 이 장의 “투인원” 설정은 Bilibili 크리에이터 Fiveth_의 방법을 참고했습니다(영상: BV1hyhPzoEcd). 이에 감사드립니다.

Obsidian에서 WeChat으로 발행하기: 내가 플러그인을 만든 방법

Mon, 01 Jan 0001 00:00:00 +0000

📌 편집자 주: 이 글은 원래 WeChat Publisher에 무료 버전과 유료 버전이 있을 때 작성되었습니다. v0.1.13부터 WeChat Publisher는 개인 사용자에게 완전 무료입니다. 모든 기능(형식 미리보기, HTML 복사, 초안 발행, 다중 계정, 커버 시스템 등)이 활성화 코드 없이 바로 사용 가능합니다. 이에 따라 이 글에서 유료/활성화 코드 관련 내용을 제거했습니다. 원문 스크린샷에는 여전히 ‘활성화 구매’ 버튼이 보일 수 있으나, 새 버전에서는 해당 항목이 제거되었으니 무시해 주세요.

지난 장에서는 Obsidian에서 관리와 운영에 사용할 수 있는 도구들을 다뤘습니다. 이번 마지막 장은 방향을 바꿔서, Obsidian에서 작성한 글을 WeChat에 발행하는 방법을 소개합니다.

글을 다 썼습니다. 이제 어떻게 WeChat에 발행할까요?

이 단계에서 많은 사람들이 막힙니다. 글을 못 써서가 아니라, 쓰고 나서 발행을 못 하거나 형식이 완전히 깨지기 때문입니다.

이 장에서는 그 문제를 해결하고, 제가 직접 만든 플러그인인 WeChat Publisher를 소개합니다.

솔직히 말하면, 이 플러그인을 만드는 데 며칠을 틈틈이 투자했습니다. 복잡하지 않을 거라고 생각했는데, 막상 시작해 보니 예상보다 훨씬 많은 함정이 있었습니다. WeChat API의 다양한 제한, 이미지 형식 변환, HTML 인라인 스타일 호환성 문제 등 하나하나 부딪혔습니다. 다행히 결과물은 꽤 괜찮고, 한동안 사용해 보니 확실히 많은 번거로움이 줄었습니다.

플러그인을 공개하는 게 이렇게 번거로운 일인 줄 몰랐습니다!

Obsidian에서 WeChat용 글을 쓸 때의 문제점

많은 사람들이 겪는 상황부터 시작해 보겠습니다.

Obsidian에서 글을 씁니다. 코드 블록, 굵은 제목, 표 등이 있어 Obsidian에서는 멋져 보입니다. 그런데 내용을 복사해서 WeChat 공식 계정 편집기에 붙여넣으면 모든 것이 엉망이 됩니다. 코드 블록은 일반 텍스트가 되고, 제목 계층은 사라지며, 이미지는 하나하나 수동으로 업로드해야 합니다.

마치 Word에서 아름답게 문서를 작성했는데, 받는 사람이 열어보니 깨져 있는 것과 같습니다.

보통 두 가지 방법이 있습니다.

방법 1: WeChat 편집기에서 직접 작성. 형식 문제는 없지만, 편집기가 Markdown을 지원하지 않아 작성하기가 고통스럽습니다.

방법 2: Obsidian에서 작성하고 편집기에 붙여넣은 후 수동으로 형식 수정. 형식은 올바르게 되지만, 글 하나당 이 단계에 20~30분이 소요됩니다.

더 나은 방법이 있을까요? 네, 있습니다.

WeChat Publisher란 무엇인가?

요약하자면: Obsidian에서 작성하고, WeChat 형식을 바로 미리보기하며, 원클릭으로 WeChat 초안함에 발행합니다.

이 플러그인이 해주는 일: Markdown을 WeChat 호환 HTML로 렌더링하고, 로컬 이미지를 WeChat CDN에 업로드하며, Mermaid 다이어그램과 수학 공식을 이미지로 변환하고, 전체 글을 초안함에 푸시합니다. 여러분은 WeChat 백엔드에서 마지막 단계인 글 보내기만 하면 됩니다.

결과를 한번 보세요.

코드 블록 (구문 강조):

수학 공식 및 Mermaid 다이어그램:

Ruby 주석 및 가로 스크롤 이미지:

이 모든 것이 Obsidian에서 직접 전송되었으며, 수동으로 형식을 조정할 필요가 없었습니다.

핵심 기능 한눈에 보기

기능	설명
🎨 형식 미리보기	WeChat 스타일로 Markdown 실시간 렌더링, WYSIWYG
📋 HTML 복사	렌더링된 HTML을 원클릭 복사, WeChat 편집기에 붙여넣기
🚀 원클릭 발행	WeChat 초안함에 직접 푸시, 브라우저 불필요
🖼 커버 시스템	글 이미지에서 자동 커버 설정, 사용자 정의 커버 지원
👥 다중 계정	하나의 플러그인으로 여러 WeChat 계정 관리
🎨 테마 전환	8가지 내장 테마, 스타일 사용자 정의 가능

개인 사용자에게 완전 무료입니다. 상업적 사용(기업, 교육 기관, 재배포 등)의 경우 WeChat 계정 ‘HelloRanceLee’로 저자에게 연락하여 승인을 받으시기 바랍니다.

설치 방법

이 플러그인은 아직 Obsidian 공식 플러그인 마켓에 등록되지 않았습니다. 두 가지 설치 방법이 있습니다.

방법 1: BRAT을 통한 설치 (권장)

BRAT은 Obsidian 커뮤니티의 플러그인 관리 도구로, 마켓에 없는 플러그인을 설치하고 업데이트를 자동으로 관리해 줍니다.

1단계: BRAT 설치.

Obsidian에서 ‘설정’ → ‘커뮤니티 플러그인’ → ‘찾아보기’로 이동하여 BRAT을 검색하고 설치 및 활성화합니다.

2단계: WeChat Publisher 추가.

‘설정’ → ‘BRAT’을 열고 베타 플러그인 추가를 클릭한 후 저장소 URL을 입력합니다:

RanceLee233/wechat-publisher

플러그인 추가를 클릭하고 Latest version을 선택하면 BRAT이 자동으로 다운로드합니다.

3단계: 플러그인 활성화.

‘설정’ → ‘커뮤니티 플러그인’으로 돌아가 WeChat Publisher를 찾아 활성화합니다.

새 버전이 출시되면 BRAT이 자동으로 감지하거나, 수동으로 업데이트 확인을 클릭할 수 있습니다.

방법 2: 수동 설치

GitHub 접속이 불편하다면 제 블로그에서 직접 zip 파일을 다운로드할 수 있습니다:

https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

압축을 푼 후 폴더를 Obsidian 플러그인 디렉터리에 넣습니다:

your-vault-path/.obsidian/plugins/wechat-publisher/

디렉터리 구조는 다음과 같아야 합니다:

.obsidian/
  plugins/
    wechat-publisher/
      main.js
      manifest.json
      styles.css

그런 다음 ‘커뮤니티 플러그인’에서도 활성화합니다.

플러그인 열기

설치 후 Obsidian 왼쪽 사이드바에 WeChat Publisher 아이콘이 나타납니다. 클릭하여 엽니다. 또는 Cmd+P (Windows: Ctrl+P)를 누르고 WeChat Publisher를 검색할 수도 있습니다.

상단 도구 모음은 왼쪽부터 형식 · 계정 이름 · 계정 설정 · 사용자 가이드 · 렌더링 새로고침 · HTML 복사 · WeChat 붙여넣기로 이동 · 초안 발행입니다.

도구 모음 아래에는 발행 정보 영역(제목, 작성자, 커버)이 있고, 그 아래에는 글 미리보기 영역이 있습니다.

이전 버전의 스크린샷에는 여전히 ‘활성화 구매’ 버튼이 보일 수 있지만, 새 버전에서는 제거되었습니다. 모든 기능을 바로 사용할 수 있습니다.

사용법 1: HTML 복사 후 붙여넣기 (API 설정 불필요)

가장 간단한 사용법으로, 계정 설정이 필요 없습니다. 바로 작성하고 발행할 수 있습니다.

1단계: 형식 조정 (선택 사항).

상단의 형식 버튼을 클릭하여 스타일 제어 막대를 펼칩니다. 내장 테마를 전환하거나 스타일 설정으로 들어가 글꼴 크기, 줄 간격, 색상 등의 세부 사항을 조정할 수 있습니다.

처음에 마음에 드는 스타일을 설정하고 저장해 두는 것이 좋습니다. 이후 글에서는 ‘저장된 스타일 적용’을 바로 사용하여 매번 재설정할 필요가 없습니다.

2단계: ‘HTML 복사’ 클릭.

플러그인이 렌더링된 HTML을 클립보드에 형식 그대로 복사합니다.

3단계: ‘WeChat 붙여넣기로 이동’ 클릭.

브라우저가 자동으로 WeChat 백엔드를 열고, 편집기에 붙여넣을 수 있습니다.

전체 과정은 약 10초 정도 소요되며, 수동 형식 조정보다 훨씬 빠릅니다.

사용법 2: 초안함에 원클릭 발행

자주 글을 발행한다면 WeChat API를 설정하여 플러그인이 브라우저를 열지 않고도 초안함에 직접 글을 푸시하도록 할 수 있습니다.

1단계: WeChat 계정 설정

상단의 계정 설정을 클릭하여 설정 팝업을 엽니다. 팝업 상단에는 추가된 모든 계정이 탭으로 표시되며, 클릭하여 전환할 수 있습니다.

입력해야 할 필드:

필드	설명
계정 이름	원하는 이름, 여러 계정 구분용
AppID	WeChat 계정의 AppID, WeChat 개발자 플랫폼에서 획득
AppSecret	개발자 비밀 키, 플랫폼에서 수동으로 활성화 필요
기본 작성자	선택 사항, 발행 시 자동 입력
기본 커버	선택 사항, 이 계정의 고정 커버 설정

하단에는 수동으로 계정 추가 (양식 작성)와 새 계정 빠른 붙여넣기 (복사한 WeChat 플랫폼 내용에서 원클릭 자동 인식) 두 개의 버튼이 있습니다. 작성 후 저장을 클릭합니다.

새 계정 빠른 붙여넣기

양식을 작성하기 싫다면 더 빠른 방법이 있습니다. WeChat 공식 계정 플랫폼의 ‘기본 정보’ 페이지를 열고 내용을 모두 선택하여 복사한 후, WeChat Publisher 계정 설정 팝업에서 ‘새 계정 빠른 붙여넣기’를 클릭하고 내용을 붙여넣으면 플러그인이 계정 이름, AppID, AppSecret을 자동으로 인식하여 원클릭으로 추가합니다.

붙여넣는 내용 형식은 대략 다음과 같으며, 플러그인이 자동으로 파싱합니다:

Official Account
Your WeChat Account Name
AppID
wxb3f8a2e9c7d10456
AppSecret
e4a27f3c1b9d8056f2e8a3c7b4d90561

AppID 및 AppSecret 얻는 방법

1단계: developers.weixin.qq.com을 열고 ‘콘솔로 이동’을 클릭합니다.

2단계: ‘내 비즈니스’에서 WeChat 계정을 찾아 클릭합니다.

3단계: WeChat 계정 관리 백엔드에 들어가 ‘기본 정보’ 페이지에서 AppID를 찾아 (직접 복사) AppSecret 옆의 활성화를 클릭하고 QR 코드를 스캔하여 인증하면 획득할 수 있습니다.

AppSecret은 활성화하는 순간에만 전체가 한 번 표시됩니다. 즉시 복사하여 저장하세요. 그렇지 않으면 다시 생성해야 합니다.

IP 화이트리스트 설정

WeChat API는 인터페이스를 호출하는 머신의 IP 주소가 화이트리스트에 등록되어 있어야 합니다. WeChat Publisher는 사용자 컴퓨터에서 직접 API를 호출하므로, 사용자의 공인 IP를 화이트리스트에 추가해야 합니다.

플러그인에 도우미 기능이 있습니다. 계정 설정 팝업에서 ‘로컬 IP 감지’를 클릭하면 공인 IP를 자동으로 가져옵니다. ‘복사’를 클릭한 후 WeChat 플랫폼의 ‘API IP 화이트리스트’로 이동하여 붙여넣고 저장합니다.

집과 직장에서 모두 사용한다면 두 네트워크의 공인 IP가 다르므로 둘 다 추가하세요.

2단계: 초안 원클릭 발행

발행하려는 노트를 열고, 발행 정보 영역에 제목과 작성자를 입력하고 필요에 따라 커버를 설정한 후 상단의 초안 발행을 클릭합니다.

플러그인이 자동으로:

글의 로컬 이미지를 WeChat CDN에 업로드
Mermaid 다이어그램과 수학 공식을 이미지로 렌더링
렌더링된 HTML을 제목, 작성자, 커버와 함께 초안함에 제출

완료 후 WeChat 백엔드 초안함으로 가서 확인하고, 문제가 없으면 보내기를 진행합니다.

초안이 직접 발송되지는 않습니다. 백엔드에서 수동으로 보내야 합니다.

재발행 시 자동 업데이트, 중복 글 없음: 이 노트가 이전에 초안으로 발행된 적이 있다면, 수정 후 다시 ‘초안 발행’을 클릭하면 플러그인이 WeChat 플랫폼에서 기존 초안을 자동으로 찾아 업데이트하며, 새로운 중복 글을 생성하지 않습니다.

커버 설정 방법

발행 정보 영역에는 세 개의 커버 버튼이 있습니다:

버튼	설명
컴퓨터에서 커버 선택	매번 로컬 컴퓨터에서 이미지를 수동으로 선택
기본 커버	계정 설정에 미리 설정된 커버 사용
커버 지우기	커버 없음, 발행 시 자리 표시자 빈 이미지 사용

커버 우선순위: 수동 선택 > 계정 기본 커버 > 자리 표시자 이미지.

계정 설정에 기본 커버를 설정해 두면 매번 발행할 때마다 수동으로 선택할 필요가 없어 편리합니다.

지원 형식

형식	지원
코드 블록	✅ 구문 강조, 들여쓰기 및 공백 유지
수학 공식	✅ 인라인 및 블록 공식, 이미지로 렌더링
Mermaid 다이어그램	✅ 순서도, 시퀀스 다이어그램 등, 이미지로 렌더링
표	✅ 전체 스타일 복원
로컬 이미지	✅ 발행 시 WeChat CDN에 자동 업로드 (`../` 상대 경로 지원)
원격 이미지	✅ 자동 처리
Ruby 주석	✅ 여러 구문 형식
알림 블록	✅ `> [!NOTE]` / `[!WARNING]` 등
가로 스크롤 이미지	✅ 여러 이미지를 나란히 표시
#태그	✅ 캡슐 스타일로 렌더링
Obsidian Callout	✅
굵게, 기울임, 취소선, 강조	✅

글 내용이 복잡할수록 절약되는 시간이 많아집니다. 코드 블록, 수학 공식, Mermaid 다이어그램이 포함된 글이라면 수동 처리 시간이 상당히 늘어납니다.

요약

오늘 배운 내용:

Obsidian에서 WeChat용 글을 쓸 때 가장 큰 문제는 형식 변환입니다. WeChat Publisher가 이 문제를 해결합니다.
두 가지 사용 방법: HTML을 복사하여 WeChat 백엔드에 붙여넣기 (설정 불필요, 10초) 또는 API를 설정하여 초안함에 원클릭 발행 (더욱 편리)
API 설정에는 AppID + AppSecret + IP 화이트리스트가 필요하며, 한 번만 설정하면 됩니다.
코드 블록 강조, Mermaid, 수학 공식, 로컬 이미지 자동 업로드 등 복잡한 형식을 지원합니다.
v0.1.13부터 개인 사용자에게 완전 무료, 모든 기능을 바로 사용할 수 있으며 활성화 코드가 필요 없습니다.

핵심 사항:

개인 사용자에게 완전 무료이므로 부담 없이 다운로드하여 사용하세요.
상업적 사용(기업, 교육, 재배포)의 경우 WeChat 계정 ‘HelloRanceLee’로 저자에게 연락하세요.
WeChat API 설정은 한 번만 하면 되며, 튜토리얼을 따라 하면 어렵지 않습니다.
발행 전에 IP 화이트리스트를 설정해야 합니다. 그렇지 않으면 API 호출 시 오류가 발생합니다.
처음에 스타일을 설정하고 저장한 후, 각 글마다 바로 적용하는 것을 권장합니다.

최신 버전의 플러그인 받기:

GitHub: https://github.com/RanceLee233/wechat-publisher
직접 다운로드: https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

파트 5: AI 협업: Obsidian을 AI 워크벤치로 만들기

Obsidian에서의 AI 협업: 대화에서 실행으로

Mon, 01 Jan 0001 00:00:00 +0000

이 장은 다섯 번째 파트인 AI 협업을 시작합니다.

앞의 네 파트에서는 Obsidian 자체를 다루었습니다. 시작하는 방법, 설정, 글쓰기, 그리고 발행까지. 이 파트에서는 반대쪽을 다룹니다. Claude Code나 Codex처럼 로컬 파일을 직접 읽고 쓸 수 있는 AI 도구를 사용하면, Obsidian 볼트는 더 이상 당신만이 읽는 노트북이 아니라 AI가 직접 작업할 수 있는 작업대가 됩니다.

이 장에서는 먼저 시작하는 방법을 설명합니다. 난이도와 자동화 수준이 증가하는 세 가지 방법이 있습니다:

가장 간단한 방법: AI에 파일 경로를 직접 제공하여 원본 파일을 읽고 처리하게 합니다.
Obsidian CLI: 파일을 직접 읽는 것보다 효율적이며, 볼트에 파일이 많을 때 적합합니다.
Skill: 전체 워크플로를 하나의 명령어로 고정하여 완전 자동화합니다.

AI에 파일 경로 직접 제공하기

이것은 가장 간단한 방법입니다. 플러그인이 필요 없고, CLI 지식도 필요 없습니다.

여기서 말하는 AI는 Claude Code나 Codex처럼 로컬 파일을 직접 읽고 쓸 수 있는 도구를 의미하며, DeepSeek나 ChatGPT 같은 웹 기반 채팅 인터페이스가 아닙니다.

Claude Code나 Codex에 파일의 전체 경로를 주기만 하면, AI가 파일을 읽고 원본에서 직접 처리할 수 있습니다. 예를 들어:

“이 노트의 핵심 요약: /Users/yourusername/Documents/Obsidian/01Notes/some-note.md”
“이 글을 영어로 번역하고 원본을 덮어써”
“이 초안의 오타와 논리 문제를 확인하고 수정해줘”

AI는 파일 내용을 읽고, 요청을 이해한 후 수정된 내용을 다시 씁니다. 요약, 번역, 다듬기, 서식 조정 같은 일회성 작업에 이 방법이 잘 맞습니다.

진입 장벽이 매우 낮아 바로 사용할 수 있습니다. 유일한 단점은 매번 요청과 경로를 수동으로 지정해야 하므로 가끔 사용하기에 적합합니다.

Obsidian CLI

파일 경로를 직접 제공하는 방법도 작동하지만, 볼트에 파일이 많아지면 AI가 파일을 무작정 스캔하는 속도가 느려지고 결과가 정확하지 않을 수 있습니다. 이때 CLI가 필요합니다.

Obsidian을 최신 버전으로 업데이트하면 CLI 인터페이스를 사용할 수 있어 AI가 명령어를 통해 볼트를 직접 조작할 수 있습니다.

어떤 분들은 이렇게 물을 수 있습니다: “AI가 이미 내 파일을 직접 읽을 수 있는데, 왜 CLI가 필요한가요?”

비유를 들어보겠습니다. Obsidian 볼트는 수백 권의 책이 있는 도서관입니다.

CLI가 없을 때: AI가 정보를 찾으려면 선반 사이를 돌아다니며 책을 하나씩 넘기거나, 당신이 “세 번째 줄, 두 번째 책으로 가"라고 알려줘야 합니다.

CLI가 있을 때: 도서관에 검색 시스템이 생깁니다. AI가 주제를 입력하면 시스템이 어떤 파일이 관련 있는지, 어디에 있는지, 노트에 어떤 키워드가 있는지 직접 알려줍니다. 또한 새 파일을 만들고, 속성을 업데이트하고, 폴더 간에 내용을 이동할 수도 있습니다.

효율성 차이는 엄청납니다. 볼트에 파일이 많아지면 CLI 유무에 따라 AI가 정보를 찾는 정확도와 속도가 완전히 다른 수준이 됩니다.

사용 방법

가장 간단한 방법: 대화 중에 AI에게 CLI를 사용하라고 직접 지시하는 것입니다.

예를 들어, AI가 노트를 정리하게 하려면 이렇게 말하면 됩니다: “Obsidian CLI를 사용해서 내 01Notes/ 폴더에서 XXX에 관한 내용을 검색해줘.” 그러면 AI가 obsidian search 명령어를 호출하여 파일을 무작정 스캔하는 대신 검색합니다. 일반적인 명령어는 다음과 같습니다:

내용 검색: obsidian search vault="OBSIDIAN_VAULT" query="키워드" path="01Notes"
파일 읽기: obsidian read vault="OBSIDIAN_VAULT" path="04Output/filename.md"
노트 생성: obsidian create vault="OBSIDIAN_VAULT" path="target-path.md" content="..."
폴더 목록: obsidian files vault="OBSIDIAN_VAULT" folder="04Output"

이 명령어들을 외울 필요 없이, AI에게 하고 싶은 작업을 말하기만 하면 AI가 어떤 명령어를 사용할지 선택합니다.

더 편리한 방법은 이러한 작업을 Skill로 고정하는 것입니다. Skill에서 어떤 작업을 CLI로 수행할지 미리 정의하면, AI가 매번 상기시키지 않아도 Skill 규칙에 따라 자동으로 CLI를 사용합니다. 제 위챗 공식 계정 글쓰기 Skill이 이런 식으로 작동합니다. obsidian search로 자료를 검색하고, obsidian create로 글을 출력하며, obsidian property:set으로 속성을 설정하도록 지정되어 있습니다. AI가 이 Skill을 실행할 때마다 추가 지시 없이 자동으로 CLI를 사용하여 볼트를 조작합니다.

Skill: 워크플로를 하나의 명령어로 만들기

CLI는 ‘찾기’ 문제를 해결하지만, 여전히 매번 요구 사항을 수동으로 말해야 합니다. 고정된 워크플로가 있다면 Skill로 작성한 후, 나중에 하나의 명령어로 전체 프로세스를 실행할 수 있습니다.

먼저 Skill이 무엇인지 설명하겠습니다. 간단히 말해, Skill은 AI를 위해 미리 작성한 고정된 스크립트입니다. 모든 규칙, 워크플로, 서식 요구 사항을 포함합니다. 그런 다음 명령어를 내릴 때마다 AI가 이 스크립트에 따라 실행되므로 반복 설명이 필요 없습니다. Claude Code를 사용해 본 적이 있다면, Skill은 /skill-name 명령어에 해당합니다.

제가 Obsidian 파일을 처리하기 위해 Skill을 사용하는 몇 가지 시나리오는 다음과 같습니다:

영상을 텍스트로: Bilibili나 로컬 영상에서 오디오를 추출하고, 텍스트로 변환한 후 Obsidian 노트로 정리하여 받은 편지함 폴더에 바로 넣습니다.

양방향 링크 추가: 새 노트를 작성한 후, AI가 기존 노트를 스캔하여 관련 내용에 [[양방향 링크]]를 추가하여 정보 네트워크를 엮습니다.

글쓰기: 주제를 주면 AI가 자료를 검색하고, 주제 방향을 확인하며, 제 글쓰기 스타일을 학습하고, 초안을 작성하고, AI 냄새를 줄이기 위해 검토하고, 이미지를 추가한 후 최종 글을 04Output/ 폴더에 출력합니다.

교정 및 사실 확인: 완성된 초안을 AI에 던져서 문단별로 오류, 논리 문제, 확인할 가치가 있는 주장을 검토하게 합니다.

이러한 작업들은 예전에는 수동으로 했으며, 분산되어 있고 시간이 많이 들었습니다. Skill을 사용하면 하나의 명령어로 AI가 전체 프로세스를 실행하고, 주요 지점에서만 확인하면 됩니다.

개념만으로는 너무 추상적입니다. 구체적인 Skill 예시를 살펴보겠습니다.

저는 04Output/ 폴더를 위한 위챗 공식 계정 글쓰기 Skill을 만들었습니다. 주제 선정부터 발행까지의 전체 글쓰기 과정을 다룹니다. 작동 방식은 다음과 같습니다:

1단계: 주제 찾기. AI가 Reddit, Hacker News, X에서 최근 AI, 금융, 기술 분야의 인기 주제를 검색하여 몇 가지 후보 주제를 제시하면 선택할 수 있습니다.

2단계: 자료 검색. 주제가 확정되면 AI가 자동으로 최근 2년간의 관련 정보를 검색하여 지식 베이스 파일로 정리하고 저장합니다.

3단계: 방향 논의. AI가 3~4개의 글쓰기 각도와 해당 개요를 제시하면 선택할 수 있습니다. 확인 후 진행합니다.

4단계: 스타일 학습 및 초안 작성. 여러 모드 중 선택 가능: 자신이 발행한 글을 읽어 스타일을 학습하거나, Jiubian이나 Huashu 같은 작가의 스타일 템플릿을 적용하거나, 특정 글을 지정하여 즉석에서 스타일 특징을 추출합니다. 스타일을 학습한 후 초안을 작성합니다.

5단계: 검토. 세 번의 검토: 내용 정확성 확인, AI 냄새 줄이기(“주목할 만한”, “역량 강화”, “요약하자면” 같은 표현 교체), 문장 및 문단 세부 사항 다듬기.

6단계: 이미지 추가 및 발행. 이미지 자리 표시자를 삽입하고, 필요하면 위챗 공식 계정 초안함에 직접 푸시합니다.

전체 과정에서 AI는 Obsidian CLI를 사용하여 폴더를 조작합니다. 기존 노트를 자료로 검색하고, 브리핑과 지식 베이스 파일을 지정된 디렉토리에 저장하며, 최종 글을 04Output/에 출력하고 frontmatter 속성을 설정합니다. 파일을 수동으로 이동할 필요가 전혀 없습니다.

아래 스크린샷은 제가 AI에게 글쓰기 명령을 내렸을 때의 모습입니다:

이것은 04Output/ 폴더를 위한 예시일 뿐입니다. 어떤 폴더에든 자신만의 Skill을 만들 수 있습니다. 독서 노트 정리 Skill, 회의록 요약 Skill, 일지 검토 Skill 등. “이 폴더에서 AI가 나를 위해 무엇을 해주길 원하는지” 명확히 설명할 수 있다면, 그것을 Skill로 작성할 수 있습니다.

이 위챗 공식 계정 글쓰기 Skill을 오픈소스로 공개했습니다. 필요하시면 제 블로그에서 직접 다운로드할 수 있습니다: https://blog.discoverlabs.ac.cn/downloads/writing-gongzhonghao-skill/

요약

오늘 배운 내용:

가장 간단한 방법: AI에 파일 경로를 직접 제공하면 원본 파일을 읽고 처리할 수 있습니다. 요약, 번역, 수정 모두 가능합니다.
Obsidian CLI: 볼트에 파일이 많을 때 CLI는 AI에게 ‘도서관 검색 시스템’을 제공하여 정보를 더 정확하고 빠르게 찾을 수 있습니다.
Skill: 고정된 워크플로를 스크립트로 작성하여 하나의 명령어로 전체 프로세스를 실행합니다. 반복적인 워크플로에 적합합니다.

핵심 포인트:

세 가지 방법은 난이도와 자동화 수준이 증가하므로 필요에 따라 선택하세요.
CLI + Skill의 조합이 AI와 Obsidian의 진정한 심층 통합입니다.
Skill을 처음부터 작성할 필요 없이, AI가 대신 작성하도록 할 수 있습니다.

PicList와 Tencent Cloud를 이용한 이미지 호스팅

Mon, 01 Jan 0001 00:00:00 +0000

입문 섹션의 마지막 장으로, 이미지 호스팅을 설정해 보겠습니다. 02장에서 이미지 삽입을 다룰 때 잠깐 언급했었죠—이미지를 클라우드에 업로드하고, 로컬 저장소를 가볍게 유지하면 글을 발행할 때 이미지가 자동으로 따라옵니다. 이 장에서는 이 내용을 깊이 있게 다룹니다.

“이미지 호스팅 서비스"는 이미지를 클라우드 서버에 저장하고 외부 링크로 참조하는 방식으로, 로컬 첨부 파일로 보관하지 않습니다. 이 방법의 장점은 여러 가지입니다. 첫째, 로컬 저장소가 가벼워지고 많은 이미지로 인해 부풀어 오르지 않습니다. 둘째, 이미지에 영구적인 웹 링크가 생겨 블로그, 위챗 공식 계정 등 다양한 플랫폼에 글을 발행할 때 이미지를 다시 업로드할 필요가 없습니다.

하지만 한 가지 중요한 주의사항이 있습니다: 개인 정보나 API 키가 포함된 스크린샷은 이미지 호스팅에 사용하지 마세요. 이미지 호스팅 서비스의 이미지는 공개적으로 접근 가능하며, 유출 시 문제가 발생할 수 있습니다.

필요한 도구

이미지 호스팅을 구성하려면 두 가지가 필요합니다:

Image auto upload: Obsidian 플러그인입니다. 커뮤니티 플러그인 마켓플레이스에서 바로 검색하여 설치할 수 있습니다.
PicList: 이미지 호스팅 관리 소프트웨어입니다. https://piclist.cn/ 에서 다운로드하여 설치하세요.

두 가지를 모두 설치한 후 설정을 시작할 수 있습니다.

어떤 이미지 호스팅을 선택할까?

이미지 호스팅에는 많은 옵션이 있습니다. 이 튜토리얼에서는 Tencent Cloud를 사용하여 설명하겠습니다. 인터페이스가 직관적이고 초보자에게 적합하기 때문입니다. 하지만 저는 개인적으로 Cloudflare R2를 매일 사용합니다. 완전 무료이고 전 세계적으로 이미지 로딩 속도가 빠르기 때문입니다. 완전히 무료로 사용하고 싶다면 GitHub도 이미지 호스팅 서비스로 사용할 수 있습니다—이미지를 저장소에 푸시하고 raw 링크로 참조하면 됩니다. 세 가지 모두 사용 가능한 옵션입니다. 오늘은 Tencent Cloud에 초점을 맞추지만, 다른 서비스도 설정 로직은 동일합니다—PicList에서 이미지 호스팅 유형만 변경하면 됩니다.

1단계: Tencent Cloud COS 설정

먼저 https://cloud.tencent.com/ 에 접속하여 계정을 등록합니다. 그런 다음 오른쪽 상단의 “콘솔"을 클릭합니다.

콘솔에 진입한 후, 상단에서 “객체 스토리지"를 검색하거나 왼쪽 메뉴에서 찾습니다.

“버킷 생성"을 클릭합니다.

설정을 시작합니다. 지역은 가장 가까운 곳을 선택합니다(예: 저는 상하이에 있으므로 “상하이"를 선택했습니다). 이름은 원하는 이름을 사용하면 됩니다. 저는 obsidian-test를 사용했습니다. 액세스 권한은 “공개 읽기, 비공개 쓰기"를 선택해야 합니다. 그렇지 않으면 다른 사람이 이미지에 접근할 수 없습니다. 아래의 필요한 모든 확인란을 선택한 후 “다음"을 클릭합니다.

고급 설정은 모두 기본값으로 두고 “다음"을 클릭했습니다.

설정이 올바른지 확인한 후 “생성"을 클릭합니다.

생성 후 이 페이지가 나타나며 버킷이 생성되었음을 알 수 있습니다. 일단 이 상태로 둡니다.

다음으로, PicList가 버킷에 이미지를 업로드할 수 있도록 API 키를 생성합니다. https://console.cloud.tencent.com/cam/capi 로 이동하여 “키 생성"을 클릭합니다. 보안 경고가 나타나면 확인합니다.

생성 후 SecretId와 SecretKey가 표시됩니다. 이 정보와 AppID, 버킷 이름을 즉시 로컬에 저장하세요. 누구와도 공유하지 마십시오.

2단계: PicList 설정

PicList를 열고 왼쪽에서 “이미지 호스팅"을 선택한 후 “추가"를 클릭합니다.

설정 양식이 나타납니다. “구성 이름"은 원하는 이름을 입력하면 됩니다. 다른 필드에는 앞서 저장한 정보(AppID, SecretId, SecretKey, 버킷 이름)를 입력합니다. 한 가지 중요한 점: 지역은 병음 형식으로 입력해야 합니다. 예를 들어 상하이는 ap-shanghai, 광저우는 ap-guangzhou를 사용합니다. 한자는 사용하지 마세요.

설정 후 문제가 발생하면 공식 문서 https://piclist.cn/configure.html 을 참조하여 매개변수를 확인하세요.

설정 후 PicList에서 먼저 테스트 이미지를 수동으로 업로드하여 이미지 호스팅이 제대로 작동하는지 확인하는 것이 좋습니다. Obsidian에서만 문제를 발견하면 문제 해결이 훨씬 번거롭습니다.

3단계: Image auto upload 플러그인 설정

Obsidian에서 Image auto upload 플러그인 설정을 엽니다. 이미지 호스팅 유형을 “PicGo"로 설정한 후 두 개의 API 엔드포인트를 입력합니다:

업로드 엔드포인트: http://127.0.0.1:36677/upload
삭제 엔드포인트: http://127.0.0.1:36677/delete

PicGo를 선택하면 자동으로 입력되는지 확실하지 않아 여기에 포함시켰습니다. 다른 설정은 제 스크린샷을 참고하세요.

사용 방법

설정이 완료되면 평소처럼 글을 쓰면서 스크린샷을 찍고 로컬 이미지를 삽입하기만 하면 됩니다—이미지 호스팅에 대해 신경 쓸 필요가 없습니다. 글을 다 쓰고 검토한 후, 명령 팔레트에서 “Upload all images"를 검색합니다. 그러면 글에 있는 모든 로컬 이미지를 한 번에 이미지 호스팅 서비스에 업로드합니다. 링크는 자동으로 교체되고 원래 로컬 첨부 파일은 삭제됩니다.

한 가지 흔한 실수: 글에 이미 이미지 호스팅에 업로드된 이미지와 새로 추가된 로컬 이미지가 함께 있는 경우, 먼저 “Download all images"를 클릭하여 호스팅된 이미지를 다시 다운로드한 후, “Upload all images"를 클릭하여 모두 함께 업로드하는 것이 좋습니다. 바로 업로드하면 이미지 정렬 문제가 발생할 수 있습니다.

위챗 공식 계정 사용자 참고 사항

한 가지 중요한 점을 분명히 해야 합니다: Obsidian은 Markdown으로 작성하지만, 위챗 공식 계정 백엔드는 Markdown을 지원하지 않습니다. 내용을 직접 복사하면 서식이 완전히 깨지고 이미지도 표시되지 않습니다—이미지 호스팅 링크가 차단되어서가 아니라 렌더링 자체가 되지 않기 때문입니다.

두 가지 해결 방법이 있습니다. 하나는 doocs-md 같은 온라인 서식 도구를 사용하는 것입니다: Obsidian 내용을 붙여넣으면 Markdown을 위챗 백엔드가 인식하는 형식으로 렌더링해 줍니다. 그런 다음 위챗 백엔드에 복사하면 이미지가 올바르게 표시됩니다. 다른 하나는 제 위챗 발행 플러그인을 사용하는 것입니다. Obsidian 내에서 직접 작동하며, 렌더링 후 원클릭 초안 푸시를 지원하거나 렌더링된 내용을 수동으로 복사할 수 있습니다. 자세한 내용은 이 책의 20장을 참조하세요. v0.1.13부터 개인 사용자에게 완전 무료입니다.

요약

이미지 호스팅은 광범위한 주제이며, 이 장에서 다루지 않은 많은 내용이 있습니다(예: 이미지 형식 변환, 자동 이름 규칙, 사용자 정의 도메인 바인딩 등). 하지만 이 장에서 설명한 설정만으로도 시작할 수 있으며, 스스로 더 탐구해 볼 수 있습니다.

오늘 배운 내용:

이미지 호스팅은 이미지를 클라우드에 저장하여 Obsidian 저장소를 가볍게 유지하고 블로그 등에 쉽게 발행할 수 있게 합니다.
Image auto upload 플러그인과 PicList 소프트웨어를 설치해야 합니다. 이미지 호스팅 옵션으로는 Tencent Cloud, Cloudflare, GitHub 등이 있습니다.
설정 후 PicList에서 먼저 수동으로 이미지 업로드를 테스트하여 모든 것이 제대로 작동하는지 확인한 후 Obsidian에서 사용하세요.
글을 쓰는 동안 평소처럼 로컬 이미지를 삽입하고, 완료 후 모든 이미지를 한 번에 이미지 호스팅에 업로드하면 링크가 자동으로 교체됩니다.

핵심 사항:

개인 정보나 API 키가 포함된 스크린샷은 이미지 호스팅에 업로드하지 마세요.
버킷은 “공개 읽기"로 설정해야 합니다. 그렇지 않으면 이미지에 공개적으로 접근할 수 없습니다.
API 키(SecretId/SecretKey)는 로컬에 저장하고 공유하지 마세요.
지역은 병음 형식으로 입력해야 합니다(예: ap-shanghai).
글에 호스팅된 이미지와 로컬 이미지가 모두 포함된 경우, 먼저 모두 다운로드한 후 함께 업로드하세요.
위챗 공식 계정 사용자: 위챗은 외부 이미지 링크를 차단합니다. doocs-md를 사용하여 변환하거나 제 플러그인을 사용하여 한 번에 처리하세요.

Web Clipper로 웹페이지를 Obsidian에 저장하는 방법

Mon, 01 Jan 0001 00:00:00 +0000

템플릿에 대해 다뤘습니다. 변수를 사용해 날짜와 제목을 자동으로 채우고, 새 노트를 만들 때 한 번의 클릭으로 서식을 적용하는 방법이었죠. 이제 한 걸음 더 나아가 보겠습니다.

메모만으로는 부족합니다. 매일 트위터를 둘러보고, 위챗 기사를 읽고, Reddit을 스크롤합니다. 좋은 내용을 발견했을 때 어떻게 저장하시나요? 스크린샷? 이미지가 되어 검색이 불가능합니다. 복사-붙여넣기? 서식이 엉망이고, 제목과 링크를 수동으로 추가해야 합니다. 브라우저 북마크에 넣기? 북마크의 영원한 안식처입니다. 들어가기만 하고 나오지 않으며, 다시는 보지 않게 됩니다.

이 장에서는 그 문제를 해결합니다: 웹 콘텐츠를 Obsidian에 빠르고 깔끔하게 저장하는 방법입니다. 도구는 Obsidian 공식 브라우저 확장 프로그램인 Web Clipper입니다.

왜 Web Clipper를 사용해야 할까요?

Web Clipper 이전에는 웹 기사를 저장하는 데 대략 세 단계를 거쳤습니다:

첫 번째 단계: 스크린샷. 한 번 클릭, 노트에 넣기. 문제: 스크린샷은 검색이 안 됩니다. 석 달 후에 무엇을 캡처했는지조차 모르고, 찾을 수도 없습니다.

두 번째 단계: 복사-붙여넣기. 텍스트를 Obsidian에 복사한 다음 제목과 출처 링크를 수동으로 추가합니다. 문제: 서식이 대부분 깨집니다. 제목이 본문 텍스트가 되고, 굵은 글씨가 사라지며, 코드 블록이 일반 텍스트가 됩니다. 매번 정리하는 데 몇 분씩 걸립니다.

세 번째 단계: 북마크. 브라우저에서 별표를 클릭, 가장 쉽습니다. 대가: 그 링크를 다시는 열지 않게 됩니다.

Web Clipper의 논리: 한 번 클릭으로 저장, 깔끔한 서식, 자동 메타데이터, Obsidian에 직접 저장. 제목, 원본 링크, 저장 날짜가 모두 자동으로 채워집니다. 콘텐츠는 Markdown 형식이며, 이미지도 보존됩니다. AI 해석기를 사용하면 클리핑하면서 AI가 콘텐츠를 요약하도록 할 수도 있습니다.

설치

Web Clipper는 브라우저 확장 프로그램입니다. 현재 Chrome, Edge, Firefox, Safari를 지원합니다 (일부 기능은 다를 수 있음).

중요: 위챗 기사는 먼저 브라우저에서 열어야 합니다. 위챗 클라이언트에서는 직접 사용할 수 없습니다. 위챗 클라이언트는 별도 환경이므로 브라우저 확장 프로그램이 접근할 수 없습니다. 링크를 복사하여 Chrome이나 Edge에서 연 다음 클리핑하세요.

설치 단계

1단계: Chrome 사용자는 Chrome 웹 스토어를 열고 “Obsidian Web Clipper"를 검색한 후, 공식 확장 프로그램(Obsidian과 동일한 아이콘, 보석 패턴)을 찾아 “Chrome에 추가"를 클릭합니다.

2단계: Edge 사용자는 마찬가지로 Edge 부가 기능 스토어를 열고 “Obsidian Web Clipper"를 검색하여 설치합니다. Edge는 Chrome 웹 스토어 버전도 사용할 수 있으며, 둘 다 가능합니다.

3단계: 설치 후 확장 프로그램 아이콘이 오른쪽 상단 도구 모음에 나타납니다. 보이지 않으면 도구 모음 맨 오른쪽에 있는 퍼즐 조각 아이콘(확장 프로그램)을 클릭하여 Obsidian Web Clipper를 찾아 도구 모음에 고정합니다.

설치는 이것으로 끝입니다.

기본 설정

도구 모음에서 확장 프로그램 아이콘을 클릭하여 클리핑 패널을 엽니다. 오른쪽 아래에 작은 톱니바퀴 아이콘이 있는데, 이것이 설정 진입점입니다. 설정으로 들어가 기본 사항을 구성합니다.

Obsidian 저장소 연결

설정에서 가장 먼저 할 일은 저장소를 연결하는 것입니다. “저장소” 섹션에서 “저장소 추가"를 클릭하고 Obsidian 왼쪽 아래에 표시된 저장소 이름을 입력합니다. 예를 들어 제 저장소 이름은 “Obsidian Vault"이므로 그대로 입력합니다.

참고: 처음 연결할 때 Obsidian에서 Web Clipper 접근을 허용할지 묻는 권한 창이 나타납니다. “허용"을 선택하세요. 이는 정상적인 보안 알림입니다.

기본 저장 폴더 설정

저장소를 연결한 후 기본 위치를 설정합니다.

전용 인박스 폴더(예: 00-Inbox 또는 Inbox)를 만들어 클리핑된 콘텐츠를 전용으로 저장하는 것이 좋습니다. 저장소 루트에 바로 덤프하지 마세요. 시간이 지나면 루트가 지저분해지고 어떤 노트가 정리된 것이고 어떤 것이 처리되지 않은 웹 아카이브인지 알 수 없게 됩니다.

인터페이스 개요

설정을 마친 후 확장 프로그램을 열 때마다 세 가지 주요 영역이 표시됩니다:

상단: 속성 영역 — 현재 페이지의 제목, URL, 작성자(가능한 경우)를 자동으로 식별합니다.
중간: 콘텐츠 미리보기 영역 — 본문이 Markdown으로 변환되었습니다.
하단: 작업 영역 — 저장할 저장소와 폴더를 선택하고 템플릿을 선택한 다음 “클리핑"을 클릭하여 저장합니다.

AI 해석기

Web Clipper에서 가장 많은 시간을 투자할 가치가 있는 기능입니다.

무엇인가요?

AI 해석기를 사용하면 템플릿에 지시문을 작성하고, 클리핑할 때 “Obsidian에 추가” 버튼을 클릭하면 AI가 지정된 콘텐츠를 처리합니다. 예: 전체 텍스트 요약, 키워드 추출, 번역… 프롬프트를 어떻게 작성하느냐에 따라 가능한 작업이 달라집니다.

이 기능을 사용하려면 API 키가 필요합니다. 이미 OpenAI, DeepSeek, Anthropic의 API 키가 있다면 바로 사용할 수 있고, 없다면 해당 플랫폼에 등록하세요.

구성

설정으로 이동하여 “해석기” 탭을 찾습니다.

1단계: 모델 소스를 선택하고 해당 API 키를 입력합니다. OpenAI, Anthropic(Claude), Ollama(로컬 모델) 등을 지원합니다. 저는 DeepSeek를 사용합니다 — 기사 요약에 가장 좋다고 생각합니다.

2단계: “해석기 활성화"를 켜고 이 스위치를 활성화합니다.

그런 다음 템플릿에 프롬프트 변수를 작성하면 클리핑할 때 확장 프로그램 창에 해석기 영역이 나타나 클릭하여 실행할 수 있습니다.

사용자 정의 템플릿 만들기

Web Clipper에는 기본 템플릿이 포함되어 있습니다 — 작동은 하지만 훌륭하지는 않습니다. 몇 분만 투자하여 자신만의 템플릿을 만들면 모든 클리핑이 훨씬 편리해집니다.

템플릿을 사용자 정의하는 이유

콘텐츠 유형에 따라 필요한 정보가 다릅니다:

기술 기사: 제목, 링크, AI 요약, 본문
위챗 기사: 제목, 작성자, 발행일, AI 요약
제품 페이지: 제목, 가격, 링크, 본문은 필요 없음

하나의 템플릿으로 모든 시나리오를 다룰 수 없습니다. 콘텐츠 유형에 따라 몇 개의 템플릿을 만들고 클리핑할 때 적절한 것을 선택하면 매우 편리합니다.

템플릿 설정 접근

Web Clipper 설정에서 왼쪽의 “새 템플릿"을 클릭하여 새 템플릿을 만듭니다. 저는 게을러서 하나만 사용합니다.

템플릿 이름을 지정합니다(예: “기사 수집”). 그런 다음 콘텐츠 작성을 시작합니다.

템플릿 변수

Web Clipper는 두 가지 유형의 변수를 지원합니다:

페이지 변수 — 현재 웹페이지에서 자동으로 추출됩니다:

변수	설명
`{{title}}`	페이지 제목
`{{url}}`	현재 페이지 URL
`{{author}}`	기사 작성자(인식된 경우)
`{{date}}`	오늘 날짜
`{{content}}`	본문 콘텐츠(Markdown 형식)

해석기 변수 — 속성 또는 콘텐츠에서 AI를 호출합니다:

해석기 구문은 간단합니다. AI에게 전달할 지시문을 큰따옴표 안에 넣고, 이중 중괄호로 감쌉니다. 다음과 같이:

{{"Summarize the full article without using an H1 heading"}}

안쪽 텍스트는 AI에 대한 지시문입니다. 바깥쪽 {{" "}} 형식은 변경하지 마십시오. Web Clipper는 이 구문을 인식하여 클리핑할 때 AI를 호출합니다.

속성과 콘텐츠 모두에서 사용할 수 있습니다. 속성 필드가 AI에 의해 자동으로 채워지도록 하려면 속성 값에 이 형식을 작성하고, 콘텐츠에 AI 요약을 삽입하려면 거기에도 작성하면 됩니다.

완전한 템플릿 예제

제가 사용하는 템플릿입니다:

템플릿 속성:

URL: {{url}}
Saved: {{date}}

템플릿 콘텐츠:


# Summary

한 가지 언급할 점이 있습니다: 작성자 줄은 {{author|split:", "|wikilink|join}}를 사용하고, 단순한 {{author}}가 아닙니다. 이는 변수 + 필터 조합입니다. 먼저 작성자 필드를 쉼표로 분할한 다음(일부 기사는 여러 작성자를 인식함), 각 이름을 Obsidian 위키링크 형식 [[작성자 이름]]으로 변환하고, 마지막으로 다시 결합합니다. 이렇게 하면 클리핑 후 작성자 이름을 클릭하면 해당 노트로 이동합니다. 꼭 이렇게 할 필요는 없습니다. {{author}}로 일반 텍스트를 출력해도 괜찮습니다. 취향에 따라 선택하세요.

콘텐츠 영역은 빈 줄 두 개만 남겼습니다: 주제 분류/링크는 수동으로 관련 정보를 추가하기 위한 것이고, # 요약은 제목 자리 표시자입니다. 해석기가 활성화되어 있으면 그 아래에 {{"전체 기사를 H1 제목 없이 요약해 주세요"}}를 추가하여 AI가 내용을 자동으로 채우도록 할 수 있고, 그렇지 않으면 클리핑 후 수동으로 몇 문장을 작성할 수 있습니다.

실습: 기사 클리핑하기

모든 설정이 완료되었습니다. 이제 실제로 사용해 보겠습니다.

마음에 드는 위챗 기사를 발견했다고 가정해 보겠습니다.

1단계: 링크를 복사하여 브라우저에서 엽니다. 위챗 기사에서 오른쪽 상단 메뉴를 탭하고 “기본 브라우저에서 열기"를 선택합니다.

2단계: Web Clipper 아이콘을 클릭합니다. 오른쪽 상단 도구 모음의 보석 아이콘을 클릭하여 클리핑 패널을 엽니다.

3단계: 속성을 확인합니다. 패널이 자동으로 기사 제목과 URL을 인식합니다. 작성자 필드가 인식되지 않으면 수동으로 입력합니다. 날짜는 오늘이므로 변경할 필요가 없습니다.

4단계: 템플릿을 선택합니다. 생성한 “기사 수집” 템플릿을 선택합니다. AI 해석기가 활성화되어 있으면 회전하는 애니메이션이 표시됩니다 — AI가 요약을 생성 중입니다. 완료될 때까지 기다립니다.

5단계: “Obsidian에 추가"를 클릭합니다. 1초 후 Obsidian을 열어 인박스 폴더로 이동하면 기사가 있습니다. 제목, 링크, 날짜, AI 요약이 모두 있고 콘텐츠는 깔끔한 Markdown입니다.

요약

오늘 배운 내용:

Web Clipper는 Obsidian의 공식 브라우저 확장 프로그램으로, 웹페이지를 한 번 클릭으로 Obsidian 노트로 저장하며 서식이 깔끔하고 메타데이터가 자동으로 추가됩니다.
위챗 기사는 브라우저에서 열어야 클리핑할 수 있습니다. 위챗 클라이언트에서는 사용할 수 없습니다.
AI 해석기는 API 키가 필요합니다. 구성하면 클리핑 중에 자동으로 요약을 생성하고 정보를 추출할 수 있습니다.
사용자 정의 템플릿 = 속성 변수 + AI 프롬프트. 콘텐츠 유형에 따라 다른 템플릿을 사용하면 클리핑 효율이 높아집니다.

핵심 포인트:

전용 인박스 폴더를 만드세요. 클리핑된 콘텐츠를 저장소 루트에 직접 덤프하지 마십시오.
먼저 기본 템플릿으로 워크플로를 작동시킨 다음, 시간을 들여 템플릿을 사용자 정의하세요. 템플릿은 언제든지 변경할 수 있습니다. 시작하는 것이 더 중요합니다.
AI 요약은 보너스이지 필수가 아닙니다. API 키 없이도 정상적으로 클리핑할 수 있습니다. AI 처리 단계만 없을 뿐입니다.

YouTube 동영상을 Obsidian에 클립하기

Mon, 01 Jan 0001 00:00:00 +0000

이전 장에서 Web Clipper를 기억하시나요? Obsidian의 공식 브라우저 확장 프로그램으로, 웹 기사를 깔끔한 로컬 Markdown 파일로 한 번에 저장할 수 있습니다. 빠르고 타사 서비스에 의존하지 않습니다.

안타깝게도 이전에는 텍스트만 클립할 수 있었습니다. 하지만 최근에 조용히 버전 1.4로 업데이트되면서 제 눈을 반짝이게 만든 새로운 기능이 추가되었습니다:

이제 YouTube 동영상 클립을 지원합니다.

이는 스크린샷을 찍거나 링크를 저장하는 것과 같은 반쪽짜리 작업이 아닙니다. 대신 타임스탬프가 포함된 전체 대본을 추출합니다. 자막 줄을 클릭하면 해당 지점으로 이동할 수 있으며, 동영상이 재생됨에 따라 자막이 자동으로 스크롤됩니다.

이 기능은 오랜 고민을 해결해 주었습니다. 동영상을 보면서 노트를 작성할 때 더 이상 일일이 멈춰서 자막을 수동으로 입력할 필요가 없어졌습니다.

먼저, Web Clipper에 대한 간단한 복습

이 플러그인을 처음 들어보신다면 간단한 배경 설명을 드리겠습니다.

Web Clipper는 Obsidian의 공식 브라우저 확장 프로그램으로, Chrome, Edge, Firefox 등 주요 브라우저를 지원합니다. 핵심 기능은 웹 콘텐츠를 한 번의 클릭으로 로컬 Markdown 파일로 저장하는 것입니다. 깔끔한 형식, 완전 오프라인, 타사 클라우드 서비스 불필요.

설치 및 기본 설정은 이전 장에서 다루었으므로 여기서는 반복하지 않겠습니다.

이 글에서는 바로 새로운 기능으로 넘어가겠습니다. 하지만 먼저 주의할 점: 플러그인을 버전 1.4 이상으로 업그레이드해야 합니다.

YouTube 클립 모드 진입

과정은 간단합니다.

YouTube 동영상을 열고, 브라우저 도구 모음에서 Web Clipper 아이콘을 클릭한 후, 플러그인 패널이 나타나면 ‘열린 책’ 아이콘을 찾아 클릭합니다.

클릭하면 인터페이스가 완전히 변합니다.

상단에 동영상이, 하단에 타임스탬프가 포함된 전체 대본이 표시됩니다.

이 인터페이스는 정적이지 않습니다. 동영상이 재생됨에 따라 자막이 자동으로 스크롤되어 일치하며, 현재 줄이 강조 표시됩니다. 양방향으로 작동합니다. 자막 줄을 클릭하면 동영상이 해당 지점으로 이동합니다.

이 인터페이스가 제공하는 기능

이 YouTube 자막 인터페이스의 공식 설명은 다음과 같습니다:

대화형 자막 기능을 제공하며, 동영상 고정, 자막을 통한 점프 재생, 자동 스크롤, 현재 위치 강조 표시를 지원합니다.

간단히 말해 네 가지 기능을 수행합니다:

동영상 고정: 자막을 스크롤할 때 동영상이 상단에 고정됩니다. 동영상이 계속 재생되는 동안 대본을 방해 없이 탐색할 수 있습니다.

클릭하여 이동: 관심 있는 문장을 찾아 클릭하면 동영상이 즉시 해당 위치로 이동합니다. 더 이상 진행 막대를 수동으로 끌어 시간을 추측할 필요가 없습니다.

자동 스크롤: 자막 영역이 동영상 재생과 함께 실시간으로 스크롤되므로 수동으로 따라갈 필요가 없습니다.

현재 위치 강조: 현재 재생 중인 자막 줄이 강조 표시되어 동영상에서 어디에 있는지 한눈에 알 수 있습니다.

오른쪽 상단에는 몇 가지 추가 기능이 있습니다. 자막에 밑줄을 긋거나, 텍스트를 강조하거나, 글꼴 크기를 조정할 수 있습니다.

동영상을 보관할 가치가 있다고 생각되면 오른쪽 상단의 Obsidian 아이콘을 클릭하면 일반 클립과 마찬가지로 전체 콘텐츠가 로컬에 저장됩니다.

Obsidian에 저장한 후

저장한 후 Obsidian을 열고 새 노트를 찾으세요.

상단에는 Obsidian에서 직접 재생할 수 있는 원본 동영상의 임베드 미리보기가 표시되고, 그 아래에는 타임스탬프가 포함된 전체 대본이 있습니다.

나중에 이 동영상을 다시 보고 싶을 때 브라우저를 열어 검색할 필요가 없습니다. 모든 것이 Obsidian에 있습니다. 검색, 참조, 주석 모두 한 곳에서 가능합니다.

영어를 이해하지 못한다면?

YouTube의 많은 훌륭한 동영상은 영어로 되어 있고 영어 자막이 있습니다. 하지만 해결책이 있습니다. 이전에 세 가지 방법을 다루었으며 여기서 다시 설명하겠습니다:

Immersive Translate: 이 브라우저 확장 프로그램은 YouTube 자막에 대해 이중 언어 번역을 직접 제공하여 중국어와 영어를 나란히 표시합니다. 사용하기 가장 간단합니다.

Web Clipper에서 DeepSeek 연결: Web Clipper는 AI 인터페이스 구성을 지원합니다. 클리핑 중에 자동으로 DeepSeek을 호출하여 콘텐츠를 중국어로 번역하도록 설정할 수 있습니다. 한 번 설정하면 그 후로는 완전 자동입니다. 즉, 동영상 아래의 자막이 보관함에 도착할 때 이미 번역되어 있습니다.

저장 후 Claudian으로 번역: 동영상 자막을 Obsidian에 저장한 후 Claudian 사이드바를 사용하여 번역합니다. 결과가 훌륭하며, 이중 언어 버전, 순수 중국어 버전 등을 만들 수도 있습니다.

이 세 가지 방법은 이전 글에서 다루었습니다. 질문이 있으면 언제든지 다시 참조하세요.

안타깝게도 Bilibili는 지원되지 않습니다

이 기능이 현재 Bilibili를 지원하지 않는 것은 정말 아쉽습니다. 특히 Bilibili는 제가 교육용 동영상을 주로 보는 플랫폼이기 때문입니다. 공식 팀이 향후 지원을 추가하기를 바랍니다.

다행히도 이전에 Bilibili 동영상 콘텐츠를 처리할 수 있는 무료 오픈소스 스킬을 만들었습니다. 블로그의 다운로드 페이지에서 찾을 수 있습니다. 필요하시면 확인해 보세요.

오늘 배운 내용

Web Clipper 1.4에 YouTube 동영상 클립 기능이 추가되었습니다. 이 모드로 진입하려면 플러그인 패널에서 ‘열린 책’ 아이콘을 클릭하세요.
자막 인터페이스는 네 가지 기능을 지원합니다: 동영상 고정, 클릭하여 점프 재생, 자동 스크롤, 현재 위치 강조.
저장 후 Obsidian 노트에는 원본 동영상의 임베드 미리보기와 타임스탬프가 포함된 전체 대본이 모두 포함됩니다.
영어 동영상은 장벽이 아닙니다. Immersive Translate, Web Clipper에서 DeepSeek 연결, Claudian이 세 가지 실행 가능한 솔루션입니다.
Bilibili는 현재 지원되지 않지만, 그 공백을 메울 무료 오픈소스 스킬이 있습니다.

핵심 요점

Web Clipper의 YouTube 클립은 스크린샷을 찍거나 링크를 저장하는 것이 아닙니다. 전체 대본과 타임라인을 추출합니다.
자막과 동영상은 양방향으로 연결됩니다. 자막을 클릭하면 동영상에서 해당 위치로 이동하고, 자막은 동영상 재생을 따라갑니다.
Obsidian에 저장되면 동영상 콘텐츠는 검색 가능하고 인용할 수 있는 로컬 노트가 됩니다.
필요에 맞게 세 가지 번역 방법을 사용할 수 있습니다. 언어는 장벽이 아닙니다.
Bilibili는 아직 지원되지 않습니다. 이 제한 사항을 인지하세요.

글꼴: 읽기 편안함을 위한 숨겨진 업그레이드

Mon, 01 Jan 0001 00:00:00 +0000

이전에 CSS 스니펫에 대해 다루면서, 작은 코드 조각 하나로 Obsidian 인터페이스의 다양한 세부 사항을 미세 조정하는 방법을 알려드렸습니다. 이번 장은 미화 3부작의 마지막 부분인 글꼴 변경입니다.

글꼴이라는 주제는 단순하면서도 중요합니다. 결국 글꼴 하나 바꾸는 것일 뿐이지만, 막상 바꾸고 나면 “그동안 이렇게 타협하며 살았나"라는 반응이 나올 가능성이 큽니다. 좋은 글꼴은 인터페이스를 더 화려하게 만들 뿐만 아니라, Obsidian을 열 때마다 눈의 피로를 덜어주고, 읽기가 더 매끄러워지며, 더 쓰고 싶게 만듭니다.

이 장에서는 네 가지를 다룹니다:

글꼴에는 저작권이 있습니다 – 안전하게 사용하는 방법
무료 글꼴을 다운로드할 수 있는 곳
다운로드 후 Obsidian에 설치하는 방법
제가 직접 사용하는 글꼴과 그 혼란스러운 이름

글꼴에는 저작권이 있습니다

먼저, 많은 사람들이 모르는 사실: 글꼴에는 저작권이 있습니다.

인터넷에서 글꼴 이름을 검색해 다운로드하고, 설치한 후 개인적으로 사용하는 것은 아무도 신경 쓰지 않습니다. 하지만 그 글꼴을 상업 프로젝트(예: 제품 UI, 인쇄 홍보 자료, 출시된 소프트웨어)에 사용하면 저작권을 침해할 수 있습니다.

중국어 글꼴 중에는 “무료처럼 보이지만 실제로는 저작권이 엄격한” 글꼴이 많습니다. FounderType, Hanyi와 같은 회사는 특정 라이선스 시스템을 가지고 있습니다: 개인 사용은 무료, 상업 사용은 유료입니다. 일부 디자이너와 프로그래머는 이 사실을 모르고 글꼴을 프로젝트에 바로 포함시켰다가 법적 통지서를 받기도 합니다.

하지만 Obsidian에서 메모를 작성하는 것은 거의 상업적 사용이 아니므로 어떤 글꼴이든 괜찮습니다.

이 이야기를 꺼낸 이유는 무료 및 오픈소스 글꼴을 우선시하는 습관을 들이기 위해서입니다. 그러면 법적 걱정 없이 사용할 수 있고, 상업적 목적으로도 사용할 수 있으며, 자유롭게 수정할 수도 있습니다.

오픈소스 글꼴은 일반적으로 SIL Open Font License (SIL OFL) 를 사용합니다. 이 라이선스는 글꼴이 무료이고, 개인 및 상업적 용도로 사용할 수 있으며, 수정 및 재배포도 가능하다는 것을 의미합니다. 유일한 요구 사항은 수정본도 동일한 라이선스로 오픈소스화되어야 한다는 것입니다.

SIL OFL이 적용된 글꼴을 선택하는 것은 “영구적으로 무료이고 걱정 없는” 글꼴을 선택하는 것과 같습니다.

글꼴 다운로드 사이트

저작권에 대해 이야기했으니, 이제 다운로드 소스에 대해 알아보겠습니다.

첫 번째 추천: Maoken.com

웹사이트: maoken.com

무료 중국어 글꼴을 모아놓은 중국어 웹사이트입니다. 수백 가지의 상업용 무료 중국어 글꼴이 있으며, 각각 미리보기 이미지와 라이선스 정보가 제공됩니다. 무엇을 선택해야 할지 모르겠다면 여기서 둘러보기만 해도 마음에 드는 글꼴을 쉽게 찾을 수 있습니다.

두 번째 추천: GitHub

많은 오픈소스 글꼴이 GitHub에 직접 공개됩니다. 예를 들어, 아래에서 추천할 LXGW WenKai 글꼴은 GitHub의 lxgw/LxgwWenKai 저장소에 있습니다. Releases 페이지로 이동하여 패키지된 글꼴 아카이브를 직접 다운로드하면 됩니다.

중국에서 GitHub에 접속할 때는 속도가 느릴 수 있습니다. Gitee 미러를 사용하거나 Maoken.com으로 바로 가도 됩니다. 많은 오픈소스 글꼴이 Maoken.com에도 수집되어 있습니다.

형식 참고 사항

일반적인 글꼴 파일 형식:

.ttf (TrueType Font): 가장 보편적이며 Mac과 Windows 모두에서 지원됩니다.
.otf (OpenType Font): 더 새로운 형식으로, 기능이 약간 더 많으며 Mac/Windows에서도 지원됩니다.

둘 다 사용 가능하므로 안심하고 사용하셔도 됩니다.

Obsidian에 글꼴 설치 방법

글꼴을 다운로드한 후에는 두 단계가 필요합니다: 먼저 시스템에 설치한 다음 Obsidian에서 사용하도록 설정합니다.

1단계: 시스템에 글꼴 설치

Mac의 경우, 다운로드한 .ttf 또는 .otf 파일을 더블 클릭합니다. 글꼴 미리보기 창이 나타납니다. 왼쪽 상단의 “글꼴 설치” 버튼을 클릭합니다. 완료.

또는 글꼴 파일을 Font Book 애플리케이션으로 직접 드래그하여 설치할 수도 있습니다.

Windows의 경우, 글꼴 파일을 마우스 오른쪽 버튼으로 클릭하고 “설치” 또는 “모든 사용자용 설치"를 선택합니다. 완료.

설치가 완료되면 글꼴이 시스템 글꼴 라이브러리에 추가되어 모든 소프트웨어에서 사용할 수 있습니다.

2단계: Obsidian에서 글꼴 활성화

Obsidian에서 글꼴을 전환하는 방법은 두 가지입니다: 인터페이스 설정을 사용하는 방법과 CSS 스니펫을 사용하는 방법입니다.

방법 1: 인터페이스 설정 (간단함, 먼저 시도해보세요)

경로: 설정 → 모양 → 글꼴

세 개의 입력 필드가 있습니다:

인터페이스 글꼴: 사이드바, 메뉴, 제목 표시줄 등 인터페이스 요소에 사용되는 글꼴
텍스트 글꼴: 노트 내용에 사용되는 글꼴 (가장 자주 변경하는 부분)
고정폭 글꼴: 코드 블록에 사용되는 고정폭 글꼴

“텍스트 글꼴” 필드에 글꼴 이름(예: LXGW WenKai)을 직접 입력하고 Enter 키를 누르면 Obsidian이 즉시 해당 글꼴로 전환됩니다.

글꼴 이름은 영문 이름이어야 하며, 대소문자를 정확히 입력해야 합니다. 이는 시스템에 설치된 글꼴의 “공식 이름"이며, 한글 표시 이름이 아닙니다.

글꼴의 영문 이름을 찾는 방법은? Mac의 경우 Font Book을 열고 글꼴을 찾으면 표시되는 이름이 영문 이름입니다. Windows의 경우 제어판 → 글꼴에서 확인할 수 있습니다.

방법 2: CSS 스니펫 (더 유연하며, 세밀한 제어에 적합)

CSS 스니펫 파일에 다음 줄을 추가합니다:

/* Set fonts */
body {
  --font-text-theme: "LXGW WenKai", "LXGW WenKai CN", serif;     /* Text font */
  --font-interface-theme: "LXGW WenKai", "LXGW WenKai CN", sans-serif; /* Interface font */
}

--font-text-theme는 텍스트 글꼴을 제어하고, --font-interface-theme는 인터페이스 글꼴을 제어합니다. 하나의 body {} 블록에 함께 넣으면 됩니다.

이 줄들을 .css 파일에 넣고 .obsidian/snippets/ 디렉토리에 저장한 후, 설정 → 모양 → CSS 스니펫에서 활성화합니다.

두 방법 모두 효과는 비슷합니다. 인터페이스 설정이 더 직관적이고, CSS 방법은 더 유연하여 다른 스니펫과 결합하여 관리할 수 있습니다. 일상적인 사용에는 인터페이스 설정으로 충분합니다.

제 선택: LXGW WenKai

방법을 설명했으니, 제 선택을 공유하겠습니다: LXGW WenKai.

이름이 조금 기억하기 어렵지만, 설치하고 나면 중국어 읽기 경험이 상당히 좋습니다. 손글씨 느낌의 정자체 스타일로, 딱딱하지 않고 오래 읽어도 눈이 편안합니다.

다운로드: GitHub lxgw/LxgwWenKai https://github.com/lxgw/LxgwWenKai/releases

제작자는 LXGW라는 이름으로 Bilibili 계정도 운영하고 있습니다.

요약

오늘 배운 내용:

추천 다운로드 사이트: Maoken.com (무료 중국어 글꼴 전문), GitHub.
글꼴 설치 과정: .ttf/.otf 파일을 더블 클릭하여 시스템에 설치 → Obsidian에서 참조.
Obsidian에서 글꼴 변경: 설정 → 모양 → 텍스트 글꼴에 글꼴의 영문 이름을 직접 입력.
고급 방법: CSS 스니펫에서 --font-text-theme 변수를 사용하여 글꼴 설정.
추천 글꼴: LXGW WenKai, 상업적 사용 무료, 중국어 읽기 경험 훌륭함.

핵심 요점:

먼저 시스템에 설치한 후 글꼴 이름을 입력하세요. 두 단계, 번거로움 없음.
글꼴의 영문 이름을 정확히 입력하고 대소문자에 주의하세요.
어떤 글꼴을 선택해야 할지 모르겠다면 Maoken.com을 먼저 둘러보세요.
LXGW WenKai는 제가 현재 사용하는 글꼴입니다. 이름은 기억하기 어렵지만 글꼴은 아름답습니다.

내가 Obsidian을 추천하는 이유

Mon, 01 Jan 0001 00:00:00 +0000

Obsidian은 진지하게 지식을 관리하려는 사람이라면 고려해볼 만한 도구입니다.

먼저 과감한 주장 하나를 해보겠습니다.

만약 평생 단 하나의 노트 앱만 써야 한다면, 나는 Obsidian을 선택할 것이다.

Obsidian이란 무엇인가?

요약하자면: Obsidian은 로컬 우선(Local-first) 마크다운(Markdown) 노트 앱입니다.

이를 세 가지 핵심 포인트로 나눠 보겠습니다.

로컬 우선: 노트는 여러분의 컴퓨터에 .md 파일로 저장됩니다. 인터넷이 필요 없고, 서버에 의존하지 않습니다.
마크다운: 표준 마크다운 문법이 Obsidian에서 바로 작동합니다. 여러분이 작성하는 모든 노트는 표준 마크다운 파일입니다.
노트 앱: 하지만 단순한 노트 작성 그 이상입니다. 지식 베이스를 구축하고, 글을 쓰고, 프로젝트를 관리하거나 블로그 편집기로도 사용할 수 있습니다.

Obsidian은 마크다운을 위해 특별히 설계된 강력한 로컬 편집기라고 생각하면 됩니다.

잠깐, 왜 노트 앱에 대해 이야기하나요?

좋은 질문입니다. Obsidian 가이드에서 “왜 노트 앱을 선택해야 하는지” 논하는 데 시간을 쓰는 이유가 뭘까요?

그 이유는 매우 중요하기 때문입니다.

첫째, AI에는 로컬 지식 베이스가 필요합니다.

ChatGPT, Claude 등과의 대화 내용은 다른 사람의 서버에 저장됩니다. 서비스가 종료되거나 계정이 차단되거나 채팅 기록이 지워지면 모두 사라집니다. 소중한 대화와 콘텐츠를 보존할 로컬 공간이 필요합니다.

게다가 AI는 ‘먹이’를 줘야 합니다. AI에게 더 체계적인 자료를 제공할수록 더 좋은 결과를 얻을 수 있습니다. 잘 정리된 로컬 노트 라이브러리는 AI와의 협업에 가장 강력한 무기입니다.

둘째, 출력(output)은 지식 축적에서 가장 중요한 부분입니다.

많은 사람들의 학습 방식은: 읽기 → 북마크 → 안다고 생각 → 실제로는 아무것도 기억하지 못함.

읽기만 하고 쓰지 않으면 배우지 않은 것과 같습니다. 무언가를 적고, 자신의 말로 재구성해야 지식이 진정으로 여러분의 것이 됩니다. Obsidian이 바로 그 일을 해줍니다. 흩어진 정보를 체계적인 지식으로 바꿔주는 거죠.

저는 지금도 Obsidian으로 모든 자료를 관리하고 있습니다. 여러분이 읽고 있는 이 장도 Obsidian에서 작성되었습니다.

따라서 노트 앱은 AI의 반대 개념이 아니라, AI 워크플로우를 위한 인프라입니다.

왜 Obsidian인가?

노트 앱은 많습니다: Notion, Evernote, Feishu Docs, Yuque… 그런데 왜 하필 Obsidian을 추천할까요?

많은 사람들이 Notion을 사용하고, 실제로 좋은 앱입니다. 하지만 비교해본 결과, 저는 여전히 Obsidian을 선택했습니다.

	Obsidian	Notion
데이터 저장	로컬 파일, 내 하드 드라이브	클라우드, Notion 서버에 저장
파일 형식	표준 마크다운 (.md 파일)	독점 형식, 내보내기 가능하지만 손실 있음
오프라인 사용	완벽 지원	지원되지만 경험은 보통
속도	매우 빠름 (로컬 작업)	인터넷 속도에 의존
무료 버전	핵심 기능 완전 무료	무료 버전에 제한 있음
플러그인 생태계	2000개 이상의 커뮤니티 플러그인	대부분 공식 통합
AI 도구 통합	로컬 파일, AI가 직접 읽고 쓰기 가능	공식 유료 서비스
데이터 보안	데이터가 내 손 안에	데이터가 남의 손 안에

가장 중요한 점: 데이터가 내 손 안에 있다는 것입니다.

Notion의 노트는 Notion 서버에 저장됩니다. 서비스가 종료되거나 정책이 바뀌거나 갑자기 요금을 부과하기 시작하면 노트는 인질이 됩니다.

저도 Notion을 많이 사용했지만, 13만 자 소설을 페이지에 넣었다가 열 수도 내보낼 수도 없게 된 후, 로컬이 진정으로 내 것임을 깨달았습니다.

물론 Notion만의 고유한 장점도 있고 Obsidian과 보완적으로 사용할 수 있습니다. 이에 대해서는 나중에 다루겠습니다.

Obsidian의 데이터는 그저 컴퓨터의 폴더일 뿐입니다. Obsidian이라는 소프트웨어가 내일 문을 닫더라도 노트는 그대로 남아 있습니다. 어떤 텍스트 편집기로든 열 수 있습니다.

여러분의 지식 베이스는 가장 중요한 디지털 자산 중 하나입니다. 남의 손에 맡기지 마세요.

다섯 가지 핵심 장점

1. 양방향 링크: 노트 간의 ‘하이퍼링크’

이것은 Obsidian의 가장 유명한 기능입니다.

일반 노트 앱은 노트를 기록만 할 뿐, 노트 간 연결이 없습니다. 하지만 진정한 지식은 고립되어 있지 않습니다. 경제학과 심리학은 교차하고, 프로그래밍 사고는 글쓰기에 적용될 수 있으며, 어제 읽은 기사가 지난주 아이디어와 연결될 수 있습니다.

Obsidian의 양방향 링크(백링크)를 사용하면 어떤 노트에서든 다른 노트를 참조할 수 있습니다. 읽기 모드에서는 백링크가 [[]] 대괄호를 표시하지 않고 글꼴 색상만 변경되므로 보기 흉할 걱정이 없습니다:

Today I learned about [[Feynman Technique]], the core idea is to test your understanding by teaching someone else.

Feynman Technique은 클릭 가능한 링크가 되어 해당 노트로 이동합니다. 더 강력한 점은, “Feynman Technique” 노트에서 어떤 노트가 이 노트를 링크했는지도 볼 수 있다는 것입니다. 백링크의 가치: 노트가 더 이상 고립된 문서가 아니라 상호 연결된 지식 네트워크가 된다는 점입니다. 많이 쓸수록 네트워크는 더 촘촘해지고, 이전에 미처 발견하지 못한 연결고리를 찾게 됩니다.

그래프 뷰에서는 모든 노트 간의 관계를 은하수처럼 한눈에 볼 수 있습니다!

2. 로컬 저장: 데이터는 항상 내 손 안에

앞서 언급했듯이, Obsidian 노트는 폴더 안의 .md 파일일 뿐입니다.

이는 다음을 의미합니다:

잃어버릴 염려 없음—iCloud, OneDrive, 심지어 USB 드라이브 등 원하는 방식으로 백업 가능
벤더 종속 없음—앱을 전환할 때 폴더만 옮기면 됨
AI가 직접 읽고 쓸 수 있음—이것은 매우 중요하며, 나중에 더 자세히 다룸

3. 플러그인 생태계: 원하는 기능은 무엇이든

Obsidian에는 2,000개 이상의 커뮤니티 플러그인이 있습니다. 생각할 수 있는 거의 모든 요구가 이미 해결되어 있습니다:

캘린더 플러그인: 날짜별로 일일 노트와 저널 관리
칸반 플러그인: 노트를 작업 관리 보드로 전환
데이터베이스 플러그인: Obsidian에 Notion과 유사한 데이터베이스 기능 부여
AI 플러그인: Obsidian 내에서 직접 AI 대화 호출
퍼블리시 플러그인: 노트를 블로그에 원클릭 동기화

처음부터 플러그인을 설치할 필요는 없습니다. 먼저 기본 기능으로 노트를 작성하고, 특정 요구가 생기면 그때 플러그인을 찾아보세요.

4. 크로스 플랫폼 지원: 기기 간 매끄러운 전환

Windows, macOS, Linux, iOS, Android—Obsidian은 모두 지원합니다.

그리고 노트는 일반 폴더이기 때문에 iCloud나 OneDrive 동기화 디렉터리에 넣어두면 모든 기기에서 자동으로 빠르게 동기화됩니다. 컴퓨터에서 작성한 노트를 휴대폰에서 즉시 볼 수 있고, 출퇴근 길에 휴대폰에서 떠오른 영감을 집에서 컴퓨터를 열면 그대로 있습니다.

공식 동기화 서비스에 돈을 낼 필요 없이, 기존 클라우드 드라이브를 사용하면 됩니다.

5. 완전 무료

Obsidian의 핵심 기능은 개인 사용자에게 완전 무료입니다.

두 가지 유료 서비스가 있습니다:

Obsidian Sync (공식 클라우드 동기화): 월 $4—하지만 iCloud나 OneDrive 같은 무료 대안으로 완전히 대체 가능
Obsidian Publish (웹사이트로 발행): 월 $8—하지만 Hugo 같은 무료 솔루션으로 대체 가능

실제 사용 비용: $0.

Obsidian이 AI와 왜 그렇게 잘 맞을까?

이것이 Obsidian 튜토리얼에서 Obsidian을 추천하는 핵심 이유입니다.

첫째, AI가 노트를 직접 조작할 수 있습니다.

Obsidian 노트는 로컬 .md 파일이기 때문에 AI 도구(예: Claude Code)가 이 파일을 직접 읽고 편집할 수 있습니다. AI에게 노트 정리, 요약 생성, 일괄 서식 변경, 노트에서 핵심 정보 추출 등을 시킬 수 있습니다.

Notion도 완전히 불가능한 것은 아닙니다. MCP 프로토콜이나 공식 Notion AI를 통해 처리할 수 있지만, MCP는 설정门槛이 높고 편리하지 않으며, 공식 AI는 추가 요금이 필요합니다. Obsidian의 로컬 파일은 AI가 장벽 없이 바로 사용할 수 있습니다.

둘째, 노트 라이브러리는 AI의 자료 라이브러리입니다.

매일 쌓아가는 독서 노트, 기사 발췌, 아이디어 등을 모두 AI에 맥락으로 제공할 수 있습니다. 노트가 많이 축적되고 잘 정리될수록 AI의 결과물도 더 정확해집니다.

예를 들어, 이 가이드의 작성 과정은 제가 Obsidian에 축적한 자료를 AI에 주고 함께 완성한 것입니다. 자료 라이브러리 없이 AI만으로 처음부터 글을 쓰면 품질이 훨씬 떨어집니다.

셋째, 마크다운 무손실 통합.

AI의 입력과 출력은 모두 마크다운입니다. Obsidian은 기본적으로 마크다운입니다. 즉:

AI가 출력한 내용을 Obsidian에 바로 붙여넣으면 서식이 적용된 노트가 됨
Obsidian의 노트를 AI에 바로 주면 완벽하게 이해함
Word처럼 형식 변환의 번거로움이 없음—손실 제로

어떻게 다운로드하나요?

공식 웹사이트: obsidian.md 모든 주요 플랫폼을 지원합니다: Windows, macOS, Linux, iOS, Android. 공식 웹사이트를 열고 “Download"를 클릭한 후, 자신의 시스템을 선택하여 다른 소프트웨어처럼 설치하면 됩니다.

설정과 시작 방법은 다음 장에서 자세히 다루겠습니다.

요약

오늘 배운 내용:

Obsidian이란 무엇인가: 로컬 우선 마크다운 노트 앱, 데이터는 내 컴퓨터에 저장
Obsidian 가이드에서 AI를 이야기하는 이유: AI에는 로컬 자료 라이브러리가 필요하고, 출력이 지식 축적의 핵심이기 때문
왜 Obsidian을 선택하는가: 데이터가 내 손 안에, AI가 직접 조작 가능, 완전 무료
다섯 가지 핵심 장점: 백링크, 로컬 저장, 플러그인 생태계, 크로스 플랫폼, 무료
AI와 잘 맞는 이유: AI가 읽고 쓸 수 있는 로컬 파일, 노트 라이브러리 = 자료 라이브러리, 마크다운 무손실
다운로드 방법: obsidian.md, 플랫폼 선택 후 설치

핵심 정리:

단 하나의 노트 앱을 선택해야 한다면 Obsidian을 선택하라
데이터를 내 손 안에 두는 것이 가장 중요한 원칙이다
Obsidian + AI = 나만의 개인 지식 엔진

시작하기: Obsidian을 실제로 사용해보자

데일리 노트: 옵시디언 초보자를 위한 첫 번째 습관

Mon, 01 Jan 0001 00:00:00 +0000

지금까지 단축키에 대해 다뤘습니다. 자주 사용하는 명령을 키에 연결해 속도를 두 배로 높이는 방법이었죠. 이제 또 다른 핵심 플러그인인 데일리 노트에 대해 알아보겠습니다.

데일리 노트 기능은 복잡해서가 아니라, 많은 옵시디언 사용자가 설치 후 한 번도 사용하지 않고 소중한 습관을 놓치기 때문에 별도의 장을 할애할 가치가 있습니다.

왜 데일리 노트를 작성해야 할까

실제 문제부터 시작해 봅시다. 많은 사람들이 데일리 노트를 쓰지 않는 이유는 쓰고 싶지 않아서가 아니라, 타이핑하고 정리하고 무엇을 쓸지 고민하는 것이 번거롭게 느껴지기 때문입니다.

그러니 한 가지 방법부터 시작해 보세요: 음성 입력.

두보, 쉰페이 입력기, 또는 시스템에 내장된 음성 키보드 모두 사용할 수 있습니다. 데일리 노트를 열고 음성 입력으로 전환한 후 오늘 있었던 일을 몇 분간 말하고 멈추면 텍스트가 자동으로 변환됩니다. 타이핑도, 구조에 대한 고민도 필요 없습니다. 그냥 말하기만 하면 됩니다.

이렇게 하면 데일리 노트 작성의 장벽이 최소로 낮아집니다. 한 단락을 말한 후 가끔 수동으로 줄바꿈을 추가하면 2~3분이면 끝납니다.

품질에 대해 걱정하지 마세요. 단순한 기록도 완벽하게 괜찮습니다. 어디에 갔는지, 무슨 일이 있었는지, 무엇을 생각했는지 그냥 적어두면 됩니다.

중요한 것은 얼마나 잘 쓰는지가 아니라, 현재의 생각, 감정, 사건을 기록하는 것입니다.

데일리 노트로 무엇을 할 수 있을까요?

스스로 검토하는 것 외에도 점점 더 유용해지는 방법이 있습니다: 데일리 노트를 AI에 보내 검토와 요약을 요청하는 것입니다.

예를 들어, 지난주 또는 지난달의 데일리 노트를 붙여넣고 AI에게 “내가 주로 무엇에 바빴는지? 패턴이 있는지? 눈에 띄는 기분 변화는 없는지?“라고 물어보세요.

AI는 스스로는 알아차리지 못할 패턴을 찾아낼 수 있습니다. 어떤 날은 상태가 나빴는지, 언제 가장 생산적이었는지, 어떤 결정을 앞두고 마음가짐이 어떻게 변했는지 등입니다. 하나하나 뒤적이는 것보다 훨씬 효율적입니다.

데일리 노트 하나는 별 가치가 없지만, 100개의 노트는 데이터입니다.

1단계: 데일리 노트 핵심 플러그인 활성화

데일리 노트는 옵시디언의 핵심 플러그인으로, 기본적으로 비활성화되어 있습니다. 수동으로 활성화해야 합니다.

경로: 설정 → 핵심 플러그인 → “데일리 노트” 찾기 → 오른쪽 토글 스위치 켜기.

활성화하면 왼쪽 사이드바에 달력 아이콘이 나타납니다. 클릭하면 오늘의 데일리 노트가 바로 열립니다.

2단계: 데일리 노트 설정

토글을 켠 후, 핵심 플러그인에서 “데일리 노트” 줄 오른쪽에 작은 톱니바퀴 아이콘이 나타납니다. 클릭하여 설정합니다.

몇 가지 주목할 옵션:

날짜 형식

기본값은 YYYY-MM-DD입니다(예: 2026-03-09). 보통은 변경할 필요가 없습니다. 이 형식은 정렬과 검색이 쉽기 때문입니다.

선호하는 형식이 있다면(예: 요일 포함 YYYY-MM-DD dddd), 여기서 사용자 지정할 수 있습니다. 형식 규칙은 템플릿의 {{date:YYYY-MM-DD}}와 동일합니다.

새 파일 위치

데일리 노트 파일은 기본적으로 보관소 루트에 생성됩니다. 전용 폴더(예: 07 데일리 노트 또는 07 리뷰/데일리)로 변경하는 것이 좋습니다. 이렇게 하면 데일리 노트를 다른 노트와 분리하여 관리하기 쉽습니다.

템플릿 파일

여기에 데일리 노트 템플릿의 경로를 입력합니다. 설정하면 오늘의 데일리 노트를 생성할 때마다 자동으로 템플릿이 적용됩니다. 수동으로 호출할 필요가 없습니다.

이 기능은 다음 단계와 함께 작동합니다. 먼저 템플릿을 만든 후, 다시 돌아와 경로를 입력하세요.

3단계: 데일리 노트 템플릿 만들기

템플릿 폴더(예: 02 템플릿)에 새 파일을 만들고 “데일리 노트 템플릿” 또는 “데일리 기록” 등 원하는 이름을 지정합니다.

매일 기록하고 싶은 내용의 프레임워크를 작성합니다. 실용적인 기본 버전:

---
date: {{date}}
---

## What I did today

## Problems encountered

## Plans for tomorrow

이것은 템플릿 장에서 소개한 데일리 노트 템플릿 예시와 동일합니다. 이미 그때 만들었다면 새로 만들 필요 없이 그대로 사용하면 됩니다.

몇 가지 참고 사항:

{{date}}는 자동으로 현재 날짜로 대체되므로 수동으로 입력할 필요가 없습니다.
세 개의 섹션은 최소한의 프레임워크입니다. 자신의 습관에 따라 추가하거나 제거하세요.
음성 입력을 사용한다면 구조를 더 단순하게 만들 수 있습니다. 예를 들어 “## 오늘” 섹션 하나만 두고 하위 섹션 없이 의식의 흐름대로 기록하는 것입니다.
너무 복잡하게 만들지 마세요. 데일리 노트를 꾸준히 쓸 수 있는 핵심 이유는 낮은 장벽 하나입니다.

템플릿 파일을 만든 후, 이전 단계의 데일리 노트 설정으로 돌아가 템플릿 파일 경로를 입력하세요(파일 이름만 입력, 예: 02 템플릿/데일리 노트 템플릿).

4단계: 데일리 노트 작성 시작

설정이 완료되면 오늘의 데일리 노트를 여는 세 가지 방법이 있습니다.

방법 1: 도구 모음 아이콘

왼쪽 사이드바의 달력 아이콘을 클릭하면 오늘의 데일리 노트가 바로 열립니다. 아직 없으면 자동으로 생성됩니다.

방법 2: 명령 팔레트

Cmd+P를 눌러 명령 팔레트를 열고 “오늘의 데일리 노트 열기"를 입력한 후 Enter를 누릅니다.

방법 3: 단축키

매일 데일리 노트를 열 것 같다면 단축키를 할당할 가치가 있습니다(단축키 장에서 설명한 대로). 설정하면 한 번의 키 입력으로 열 수 있습니다.

편한 방법을 선택하세요. 저는 도구 모음 아이콘을 사용합니다. 한 번 클릭이면 충분합니다.

요약

오늘 배운 내용:

데일리 노트 플러그인 활성화: 설정 → 핵심 플러그인 → 데일리 노트 → 토글 켜기
세 가지 항목 설정: 날짜 형식, 저장 폴더, 템플릿 파일 경로
데일리 노트 템플릿 만들기: 템플릿 폴더에 배치, {{date}}가 자동으로 날짜를 채움
여는 방법: 도구 모음 아이콘 / Cmd+P로 “오늘의 데일리 노트 열기” 검색 / 사용자 지정 단축키

핵심 포인트:

음성 입력이 가장 쉬운 작성 방법입니다. 두보나 다른 입력 방법을 사용해 몇 분간 말하면 텍스트가 자동으로 변환되며 타이핑이 필요 없습니다.
템플릿을 너무 복잡하게 만들지 마세요. 섹션이 적을수록 꾸준히 하기 쉽습니다. 그냥 시작하세요.
데일리 노트가 쌓이면 AI에 보내 패턴을 요약하고 진행 상황을 검토할 수 있으며, 직접 뒤적이는 것보다 훨씬 효율적입니다.

로컬 백업: 초보자를 위한 최고의 백업 플러그인

Mon, 01 Jan 0001 00:00:00 +0000

여러분, 오늘은 Obsidian 백업에 대해 이야기해보겠습니다.

백업의 중요성은 말할 필요도 없죠. 실수로 삭제하거나 실수하는 것을 방지해줍니다. 특히 요즘은 많은 작업이 AI로 이루어지기 때문에, 문제가 생기면 연쇄 반응이 일어날 수 있습니다. 백업은 부분적으로 또는 완전히 복구하는 데 도움을 줍니다.

백업 옵션

두 가지 주요 접근 방식이 있습니다: 로컬 백업과 클라우드 백업.

로컬 백업은 말 그대로 로컬 컴퓨터의 다른 폴더에 하나 이상의 복사본을 만들어 필요할 때 복원하는 것입니다. 일반적인 방법으로는 파일을 수동으로 복사하거나, 플러그인을 사용하거나, Kopia 같은 도구를 사용하는 것이 있습니다.
클라우드 백업은 백업을 클라우드에 저장하는 것으로, NAS, VPS, GitHub, Cloudflare 등의 서비스를 포함합니다.

저는 둘 다 선택합니다. 제 문서는 매일 아침 9시에 로컬과 클라우드에 백업됩니다. 이중 보호!

하지만 오늘은 가장 초보자 친화적인 방법인 Local Backup 플러그인을 사용한 로컬 백업부터 시작하겠습니다.

플러그인 사용 방법

앞서 말씀드린 대로, 공식 플러그인 마켓플레이스를 열고 플러그인을 검색하여 설치합니다.

그런 다음 플러그인 설정을 엽니다. 참고로 왼쪽 사이드바에도 빠른 접근을 위한 아이콘이 나타납니다.

영어가 잔뜩 보여서 겁먹으셨나요? 걱정 마세요. 제가 다 번역해드렸습니다. 꽤 세심하죠? 😊

설정은 간단합니다. 필요한 것을 선택하기만 하면 됩니다. 잘 모르겠다면 제 구성을 참고하세요: Obsidian을 종료할 때마다 백업, 최근 7일간의 백업 유지(오래된 것은 자동 삭제), 하루 최대 2개의 백업 저장.

또한 시스템에 맞게 백업 경로를 설정하는 것을 잊지 마세요. 그렇지 않으면 기본값으로 볼트 디렉토리가 사용됩니다.

설정이 완료되면 왼쪽의 아이콘을 클릭하여 제대로 작동하는지 테스트합니다. 백업이 성공적으로 생성된 것을 확인할 수 있습니다.

녹색 알림이 뜨거나 대상 폴더에 새 백업 파일이 보이면 설정이 성공한 것입니다.

일반적인 문제

또한, 제 볼트 폴더에 가상 환경이 포함되어 있어서 이전에 오류가 발생한 적이 있습니다.

해결 방법은 간단합니다. 스크린샷에 표시된 옵션에서 제외 패턴을 추가하면 됩니다. 잘 모르겠다면 제 목록을 복사하세요:

.venv, __pycache__, node_modules, .git, .trash

팁: PDF를 Markdown으로 변환하여 백업 크기 줄이기

백업 패키지가 계속 커진다면, 먼저 볼트에 PDF를 많이 추가했는지 확인하세요.

PDF 파일은 크기가 크기 때문에, PDF가 많으면 백업이 비대해집니다. 참고 PDF를 Markdown으로 변환하면 내용은 유지하면서 백업 크기를 크게 줄일 수 있습니다. 예를 들어, 504KB PDF는 변환 후 13KB에 불과합니다(비율은 파일에 따라 다릅니다).

이미지에 대해서는 걱정하지 마세요. 변환 도구가 자동으로 이미지 호스팅 링크로 삽입해줍니다.

현재 무료 온라인 도구를 사용할 수 있습니다:

사용법은 간단합니다. PDF를 끌어다 놓기만 하면 변환됩니다.

변환 후 왼쪽에는 원본이, 오른쪽에는 변환된 형식이 표시됩니다. 오른쪽의 다운로드 버튼을 클릭하여 로컬에 저장합니다.

원본 PDF는 504KB인 반면, 변환된 버전은 13KB에 불과한 것을 확인할 수 있습니다.

아래 이미지는 PDF와 Markdown 버전을 비교한 것으로, 매우 유사해 보입니다.

이 이미지들은 웹사이트 자체 이미지 호스팅 서비스에 호스팅되어 있으며, 얼마나 오래 보존될지 확실하지 않습니다. 이미지 호스팅 챕터에서 설명한 대로 자신의 이미지 호스팅으로 마이그레이션하는 것이 좋습니다. 그래야 웹사이트가 호스팅을 제거하더라도 사용에 영향을 받지 않습니다.

노트를 작성할 때는 분할 화면을 사용할 수 있습니다. 같은 문서를 양쪽에 열고, 한쪽에서는 변환된 Markdown을 보면서 다른 쪽에서는 노트를 작성합니다. 듀얼 모니터 설정을 사용하면 더욱 편리합니다.

요약

오늘 배운 내용:

Local Backup은 Obsidian을 위한 가장 간단한 로컬 백업 플러그인입니다. 설치하고 경로만 설정하면 명령줄 없이도 작동합니다.
설정은 세 단계만 거치면 됩니다: 플러그인 설치 → 백업 경로 및 규칙 설정 → 왼쪽 아이콘을 클릭하여 확인.
의존하기 전에 테스트하세요. “시도"를 클릭하여 경로에 쓸 수 있는지 확인하세요. 데이터를 잃고 나서 확인하지 마세요.
일반적인 오류 해결 방법: 제외 목록을 확인하고 .venv, node_modules, .git 등의 임시 디렉토리를 추가하세요.

핵심 요점:

로컬 백업 + 클라우드 백업으로 이중 보호 – 이것이 가장 신뢰할 수 있는 방법입니다.
초보자는 로컬 백업만으로 시작할 수 있습니다. NAS나 GitHub 동기화에 바로 뛰어들 필요가 없습니다.
백업에 의존하기 전에 한 번 확인하여 경로와 제외 설정이 올바른지 확인하세요.

파트 2 · 워크플로우: 매일 열게 만드는 방법

명령어 플러그인: 컨텍스트 메뉴 사용자 정의하기

Mon, 01 Jan 0001 00:00:00 +0000

지금까지 많은 작업을 다루면서 명령어를 자주 언급했지만, 아마도 그런 워크플로에 익숙하지 않을 수도 있다는 점을 알고 있습니다. 자주 하는 작업의 경우 Commander 플러그인을 사용해 컨텍스트 메뉴에 추가하면 훨씬 편리하게 접근할 수 있습니다.

간단히 말해: 자주 사용하는 명령어를 골라 컨텍스트 메뉴에 바로 고정하는 것입니다. 언제든지 우클릭으로 접근할 수 있어 매번 명령 팔레트를 열 필요가 없습니다.

Commander 플러그인 설치하기

설정을 열고, 커뮤니티 플러그인으로 이동한 후 command를 검색하고, Commander 플러그인을 찾아 설치하세요.

이름에 “command"가 들어간 플러그인이 여러 개 있습니다. Johnny와 phibr0가 만든 Commander를 찾으세요. 다운로드 수가 47만 이상입니다. 올바른 플러그인을 선택했는지 확인하세요.

플러그인 설정 열기

설치 후, 설치된 플러그인 목록에서 Commander를 찾아 오른쪽의 톱니바퀴 아이콘을 클릭해 설정을 엽니다.

편집기 메뉴 접근하기

설정 화면에 들어가면 여러 탭이 보입니다: 일반, 왼쪽 리본, 홈페이지, 상태 표시줄, 편집기 메뉴… 우리는 컨텍스트 메뉴를 사용자 정의하려고 하므로 편집기 메뉴 탭을 클릭하세요.

기본 명령어가 이미 몇 개 있습니다. 아래로 스크롤하여 명령어 추가 버튼을 클릭하세요.

명령어 검색 및 선택

검색 상자가 나타나면 먼저 키워드를 입력하고, 명령어 목록이 나타날 때까지 기다린 후 선택하세요.

반드시 먼저 키워드를 입력한 후 목록에서 선택해야 합니다. 목록이 비어 있을 때 클릭하지 마세요. 그렇지 않으면 원하는 명령어를 찾지 못할 수 있습니다. 명령어가 너무 많아 기본 표시가 불완전하기 때문입니다.

명령어 이름 지정하기

명령어를 선택하면 사용자 정의 이름을 입력하라는 대화상자가 나타납니다. 컨텍스트 메뉴에서 쉽게 식별할 수 있도록 설명적인 이름을 사용하는 것이 좋습니다.

(때로는 이 단계 전에 아이콘을 선택하라는 요청이 있을 수 있습니다. 아무거나 선택하거나 건너뛰어도 기능에 영향을 주지 않습니다.)

결과 확인하기

완료되면 편집기 아무 곳에서나 우클릭하면 새로 추가된 명령어가 메뉴에 나타납니다.

이것으로 여섯 단계가 끝났습니다. 이제 우클릭만으로 명령어를 사용할 수 있어 명령 팔레트를 여는 것보다 훨씬 빠릅니다.

요약

이 플러그인은 사용법이 매우 간단하지만, 일상적인 효율성을 크게 높일 수 있습니다. Obsidian에는 수백 개의 명령어가 있습니다. 가장 자주 사용하는 명령어를 컨텍스트 메뉴에 고정하고 우클릭으로 실행하면, 반복적인 열기-검색-실행 과정을 생략할 수 있습니다.

오늘 배운 내용:

Commander 플러그인을 사용하면 모든 Obsidian 명령어를 컨텍스트 메뉴, 사이드바, 상태 표시줄 등에 추가할 수 있습니다.
명령어를 추가할 때는 먼저 키워드를 입력한 후 선택해야 합니다. 그렇지 않으면 찾지 못할 수 있습니다.
명령어에 설명적인 이름을 지정하면 컨텍스트 메뉴에서 더 쉽게 식별할 수 있습니다.

핵심 포인트:

명령어를 검색할 때는 먼저 입력하고, 그다음 선택하세요. 순서가 중요합니다.
Commander는 컨텍스트 메뉴뿐만 아니라 사이드바, 상태 표시줄 등 여러 위치도 사용자 정의할 수 있습니다.
설명적인 이름이 기본 긴 영어 명령어 이름보다 훨씬 사용자 친화적입니다.

첫 번째 Obsidian Vault 만들기

Mon, 01 Jan 0001 00:00:00 +0000

이제 Obsidian이 무엇이고 왜 추천하는지 알았으니, 첫 번째 Vault를 만들어 시작해 봅시다.

Vault란 무엇인가?

Obsidian을 열면 Vault를 선택하거나 생성하라는 메시지가 나타납니다.

Vault란 무엇일까요? 간단히 말해, 폴더입니다. 모든 노트, 첨부 파일, 설정이 이 폴더에 저장됩니다. Vault = 독립적인 노트 공간입니다. 마치 별도의 노트북이라고 생각하면 됩니다.

컴퓨터에서 이 폴더를 열면 다른 폴더와 마찬가지로 여러 .md 파일과 하위 폴더가 보입니다. Obsidian은 이 폴더 위에 멋진 인터페이스와 강력한 기능을 추가한 것뿐입니다.

왜 여러 개의 Vault를 만드는가?

Obsidian은 여러 Vault 생성을 지원합니다. 왜 모든 것을 하나의 Vault에 넣지 않는지 궁금할 수 있습니다.

모든 것을 하나의 Vault에 넣을 수 있으며, 대부분의 사람들에게는 하나의 Vault로 충분합니다. 하지만 별도의 Vault가 유용한 경우도 있습니다:

소설 쓰기: 소설마다 하나의 Vault를 사용합니다. 그러면 역링크와 태그가 해당 소설에만 한정되어 다른 노트와 섞이지 않습니다.
업무와 개인 생활 분리: 업무 노트용 Vault 하나, 개인 노트용 Vault 하나. 직장을 옮길 때 업무 Vault를 삭제해도 개인 콘텐츠에는 영향을 주지 않습니다.
공유 시나리오: 가족 공유 Vault, 팀 프로젝트 Vault를 개인 노트와 분리합니다.

초보자에게 권장: 하나의 Vault로 시작하세요. 익숙해지고 분할할 필요를 느끼면 그때 하면 됩니다.

저는 개인적으로 하나의 메인 Vault를 사용하며, 폴더로 다양한 유형의 콘텐츠를 정리합니다: 받은 편지함, 노트, 템플릿, 출력물, 아카이브… 하나의 Vault로 모든 것을 처리합니다.

Vault를 만드는 방법

Apple 생태계 사용자 (권장)

iPhone/iPad와 Mac을 사용한다면, 여기 가장 쉬운 방법이 있습니다.

1단계: 휴대폰이나 iPad에서 Vault를 만듭니다.

iOS에서 Obsidian을 열고 “새 Vault 생성"을 탭한 후 이름을 지정합니다. 핵심은 기본적으로 iCloud 동기화를 선택하여 Vault가 자동으로 iCloud Drive에 저장되도록 하는 것입니다. 2단계: Mac에서 엽니다.

Mac에서 Obsidian을 열고 “기존 Vault 열기"를 선택한 후 iCloud Drive에서 방금 만든 Vault 폴더를 찾아 엽니다. 왜 이렇게 하나요? iOS에서 생성된 Vault는 자동으로 iCloud Drive의 Obsidian 폴더에 배치되며, 별도의 수동 설정 없이 동기화가 기본적으로 활성화되기 때문입니다. Mac에서 먼저 생성하면 폴더를 수동으로 iCloud 디렉터리로 이동해야 하므로 추가 단계가 필요합니다.

설정이 완료되면 휴대폰에서 작성한 노트가 즉시 Mac에 동기화되고, Mac에서 변경한 내용이 휴대폰에 즉시 나타납니다.

Windows / Android 사용자

Obsidian을 열고 “새 Vault 생성"을 클릭한 후 쉽게 찾을 수 있는 위치를 선택합니다.

여러 기기에서 동기화하려면 Vault 폴더를 OneDrive 동기화 디렉터리에 넣으세요. iCloud와 같은 원리입니다. 즉, 폴더를 클라우드 드라이브 디렉터리에 넣고 클라우드 드라이브가 나머지를 처리하도록 하는 것입니다.

Obsidian 인터페이스는 어떻게 생겼나요?

Vault를 생성하고 열면 인터페이스가 나타납니다. 겁먹지 마세요. 간단하며 세 가지 주요 영역이 있습니다.

왼쪽 사이드바: 파일 관리

가장 왼쪽 열에는 단축 버튼(검색, 그래프 보기, 일일 노트 등)이 있습니다. 이는 플러그인에서 제공하는 빠른 진입점이며, 나중에 자세히 다룰 것입니다.

그 옆에는 컴퓨터의 폴더 구조와 동일한 파일 목록이 있습니다. 새 폴더, 새 노트를 만들고 드래그하여 순서를 변경할 수 있습니다.

폴더로 노트를 정리할 수 있습니다. 컴퓨터에서 파일을 관리하는 것과 같습니다. 예를 들어, 제 Vault는 다음과 같이 나뉘어 있습니다:

00 Inbox — 임시로 넣어둔 자료
01 Notes — 공식 노트
04 Output — 완성된 글
05 Archive — 자주 사용하지 않지만 보관하는 것

제 구조를 그대로 따를 필요는 없습니다. 자신의 습관에 맞게 정리하세요. 핵심은 분류에 집착하지 말고 그냥 쓰기 시작하는 것입니다.

중앙: 편집기 영역

노트를 작성하는 곳이며, 대부분의 시간을 보내는 곳입니다.

노트를 열거나(또는 새로 만들고) 바로 쓰기 시작합니다. 앞서 배운 모든 Markdown 문법이 여기서 작동합니다. #는 제목, **는 굵게, -는 목록, [[]]는 역링크입니다.

편집기 위에는 현재 노트가 있는 폴더를 보여주는 파일 경로가 있습니다.

오른쪽 사이드바: 정보 패널

오른쪽 사이드바는 기본적으로 접혀 있습니다. 열면 여러 탭이 표시됩니다:

역링크: 현재 노트를 참조하는 노트를 보여줍니다(역링크의 핵심).
태그: 현재 노트의 태그 목록.
개요: 제목 수준에 따라 자동 생성된 목차로 탐색에 용이합니다.

처음에는 오른쪽 패널을 많이 사용하지 않을 수 있습니다. 괜찮습니다. 노트가 늘어나고 역링크를 사용하기 시작하면 역링크 패널이 매우 유용해집니다.

첫 번째 노트 작성하기

왼쪽 상단의 “새 노트"를 클릭하거나(또는 Ctrl/Cmd + N 누르기) 빈 노트가 나타납니다.

제목을 지정한 다음 쓰기 시작합니다. 예를 들어:

# My First Obsidian Note

Started using Obsidian today.

## Why Obsidian
- Data is in my own hands
- Supports Markdown
- Works well with AI

## Today's Plan
- [ ] Familiarize with the interface
- [ ] Write the first note
- [x] Install Obsidian

작성 후 노트는 자동으로 저장됩니다. Ctrl+S를 누를 필요 없이 Obsidian이 실시간으로 저장합니다.

역링크로 노트 연결하기

앞서 역링크 개념을 소개했습니다. 이제 사용 방법을 알아보겠습니다.

전체 노트 링크: [[를 입력하면 Obsidian이 자동으로 선택할 수 있는 노트 목록을 표시합니다. 하나를 선택하면 역링크가 생성되고, 클릭하면 해당 노트로 이동합니다.

Today I read [[Feynman Learning Method]], the core idea is to test yourself by teaching others.

특정 섹션 링크: 전체 노트가 아닌 제목 아래의 특정 섹션만 링크하려면 노트 이름 뒤에 #을 추가하고 제목을 선택합니다:

See [[Feynman Learning Method#Specific Steps]], the first step is to choose a concept.

이 링크를 클릭하면 “Feynman Learning Method” 노트의 “Specific Steps” 제목으로 바로 이동합니다.

이는 지식과 개념을 정리하는 데 특히 유용합니다. 예를 들어 경제학을 공부한다면 “GDP”, “인플레이션”, “금리"에 대한 별도 노트를 만들고, 이러한 개념을 사용하는 곳마다 역링크로 참조할 수 있습니다. 시간이 지나면 Vault는 개인 백과사전이 됩니다. 각 개념에 설명이 있고, 개념들이 서로 연결되어 클릭하여 이동하고 복습할 수 있습니다.

편집 보기 vs. 읽기 보기

오른쪽 상단에 두 보기 사이를 전환하는 토글 버튼(책 아이콘)이 있습니다.

편집 보기: 모든 Markdown 기호가 표시됩니다. #, **, - [ ]가 그대로 보입니다. 작성에 적합합니다.

읽기 보기: Markdown 기호가 실제 서식으로 렌더링됩니다. 제목은 더 크고 굵게, 굵은 텍스트는 실제로 굵게, 목록은 아름다운 목록이 됩니다. 읽기에 적합합니다.

실시간 미리보기라는 중간 상태도 있습니다. 작성하면서 렌더링됩니다. 커서가 있는 줄은 원시 Markdown을 표시하고, 다른 줄은 렌더링됩니다. 초보자에게 권장되며 편집과 읽기의 균형을 맞춥니다.

설정 → 편집기 → 기본 편집 모드에서 “실시간 미리보기” 또는 “소스 모드"를 선택할 수 있습니다. “실시간 미리보기"를 선택하는 것을 권장합니다.

이미지 삽입 방법

노트에는 종종 이미지가 필요합니다. Obsidian에서 이미지를 삽입하는 것은 매우 간단합니다.

방법 1: 직접 붙여넣기. 스크린샷을 찍은 후 Ctrl/Cmd + V를 눌러 편집기에 붙여넣으면 이미지가 삽입됩니다.

방법 2: 드래그 앤 드롭. 폴더에서 이미지 파일을 편집기로 직접 드래그합니다.

삽입 후 편집기에는 다음과 같은 내용이 표시됩니다:

![[screenshot-2026-02-27.png]]

이것은 Obsidian의 이미지 구문입니다. 역링크처럼 ![[]]로 파일 이름을 감쌉니다. 읽기 보기에서는 이미지가 정상적으로 표시됩니다.

이미지는 어디에 저장되나요?

초보자들이 자주 혼동하는 부분입니다. 이미지를 붙여넣으면 Obsidian이 자동으로 지정된 첨부 파일 폴더에 저장합니다.

기본적으로 이미지는 Vault 루트 디렉터리에 저장되므로 시간이 지나면 지저분해질 수 있습니다. 전용 첨부 파일 폴더를 설정하여 모든 이미지, 오디오, PDF 등 첨부 파일을 한 곳에 보관하는 것이 좋습니다.

권장 첨부 파일 설정

설정 → 파일 및 링크를 열고 다음과 같이 구성합니다:

설정	권장 값	설명
새 노트의 기본 위치	첨부 파일용 지정 폴더	새 노트가 지정된 폴더에 배치됨
새 노트를 저장할 폴더	`00 Inbox`	새 노트는 먼저 받은 편지함으로 이동한 후 나중에 분류
기본 첨부 파일 경로	첨부 파일용 지정 폴더	이미지 및 기타 첨부 파일을 통합 관리
첨부 파일 폴더 경로	`05 Archive/Assets`	모든 이미지, 오디오, PDF가 여기에 저장됨

링크 섹션:

설정	권장 값	설명
내부 링크 유형	가능한 가장 짧은 형식	역링크 경로가 더 간결해짐
내부 링크 항상 업데이트	켜기	파일 이름을 바꿀 때 모든 참조를 자동으로 업데이트, 이름 변경에 대한 두려움 없음
Wiki 링크 사용	켜기	`[[]]` 구문 사용, 표준 Markdown 링크보다 편리함

이 설정 후 Vault는 깔끔하게 유지됩니다. 노트와 첨부 파일이 각각 제자리를 찾아 섞이지 않습니다.

더 나은 솔루션: 이미지 호스팅 서비스

하지만 솔직히 말하면, 이미지를 로컬 첨부 파일 폴더에 저장하는 것이 최적의 솔루션은 아닙니다.

왜일까요? 글을 위챗 공개 계정, 블로그 또는 다른 플랫폼에 게시하려고 할 때 로컬 이미지는 업로드할 수 없습니다. 각 이미지를 수동으로 다시 업로드하고 다시 삽입해야 합니다. 글이 많으면 매우 고통스럽습니다.

더 나은 방법은 이미지 호스팅 서비스를 사용하는 것입니다. 이미지를 웹에 업로드하고 URL을 얻은 다음 Markdown에서 해당 URL을 직접 참조합니다. 이렇게 하면 어떤 플랫폼에 게시하든 이미지가 추가 처리 없이 직접 표시됩니다.

<!-- Local attachment method -->
![[screenshot-2026-02-27.png]]

<!-- Image hosting method -->
![](https://cf-img.discoverlabs.ac.cn/202602272b6a153c41f15fd574a6c29c2ae4a4e2.webp)

물론 이미지 호스팅 서비스를 사용하면 이미지가 웹에 업로드되므로 개인 정보에 주의하세요. 민감한 정보가 포함된 스크린샷은 업로드하지 마십시오.

이미지 호스팅 서비스의 구체적인 설정과 사용법은 이 튜토리얼의 마지막 장에서 다룰 예정입니다. 지금은 그런 것이 있다는 것만 알아두세요.

요약

오늘 배운 내용:

Vault란 무엇인가: 모든 노트가 저장되는 폴더입니다.
여러 Vault를 만드는 이유: 대부분의 사람들은 하나만 필요하며, 소설, 업무 또는 공유 시나리오를 위해 분할합니다.
Vault를 만드는 방법: Apple 사용자는 iPhone에서 생성하는 것을 권장(자동 iCloud 동기화). 다른 사용자는 클라우드 드라이브 디렉터리에 넣습니다.
세 가지 인터페이스 영역: 왼쪽 사이드바(파일 관리), 중앙 편집기, 오른쪽 사이드바(정보).
첫 번째 노트: Ctrl/Cmd+N으로 생성, Markdown으로 작성, 자동 저장.
두 가지 보기: 편집 보기(기호 표시), 읽기 보기(렌더링된 출력). 실시간 미리보기 권장.
이미지 삽입: 붙여넣기 또는 드래그 앤 드롭. 첨부 파일 폴더를 설정하여 Vault를 깔끔하게 유지.

핵심 요점:

분류에 집착하지 말고 그냥 쓰기 시작하세요.
하나의 Vault로 충분하며, 필요할 때 분할하세요.
권장: 실시간 미리보기 모드, 쓰기와 읽기에 모두 좋습니다.

카파시 방식: LLM으로 개인 위키 구축하기

Mon, 01 Jan 0001 00:00:00 +0000

최근 안드레이 카파시(Andrej Karpathy)의 Gist 하나가 기술 커뮤니티에서 빠르게 퍼지고 있습니다. 읽고 나서 가장 먼저 든 생각은 “이 아이디어는 대부분이 생각하는 것보다 옵시디언(Obsidian)과 더 깊은 연결점이 있다"는 것이었습니다. 이 글은 그 이야기입니다.

카파시는 누구인가

AI 업계를 팔로우한다면 이 이름은 익숙할 겁니다. 하지만 잘 모르는 분들을 위해 먼저 설명하는 게 좋겠습니다.

카파시는 “대기업에서 제품을 관리하는 AI 리더” 같은 인물이 아닙니다. 그는 진정한 딥러닝 분야의 ‘자체 제작(own)’ 인물입니다.

스탠포드에서 페이-페이 리(Fei-Fei Li) 교수 밑에서 박사 학위를 받았습니다. 페이-페이 리는 ImageNet을 주도하여 사실상 현대 컴퓨터 비전의 문을 연 사람입니다. 카파시는 페이-페이 리 연구실을 떠난 후 오픈AI(OpenAI)의 공동 창업자 중 한 명이 되었습니다. 2017년에는 테슬라(Tesla)가 그를 스카우트하여 오토파일럿(Autopilot)의 시각 인식 시스템을 이끌게 했습니다.

테슬라에서의 몇 년 동안, 지금은 많은 사람이 그 결과를 알고 있습니다. 당시 테슬라는 순수 비전 접근법을 고집한 거의 유일한 자율주행 회사였습니다. 라이다(LiDAR) 없이, 오직 카메라와 신경망만으로요. 이 접근법은 당시 너무 급진적이라는 비판을 많이 받았습니다. 그 결과는 이후 모두가 알게 되었습니다.

그는 2022년 테슬라를 떠났고, 2023년 잠시 오픈AI로 돌아왔다가 다시 떠나 자신의 AI 교육 프로젝트인 karpathy.ai를 시작했습니다.

그에게서 흥미로운 점은 이력뿐만 아니라, 그가 유지하는 드문 상태입니다. 세계적 수준의 엔지니어링을 할 수 있으면서도, 일반인에게 기술의 근본 원리를 설명하는 글을 쓰고 강의를 녹화하는 데 시간을 기꺼이 쏟는다는 점입니다.

그의 nanoGPT와 micrograd는 GitHub에서 GPT와 역전파(backpropagation)를 최소한으로 재구현한 것으로, 일반인이 진정으로 이해할 수 있도록 설계되었습니다. YouTube의 CS231n 강의는 수많은 사람에게 딥러닝을 가르쳤습니다.

그래서 그가 GitHub에 “LLM으로 지식 베이스 관리하기"라는 Gist를 올렸을 때, 기술 커뮤니티에 빠르게 퍼졌습니다. 꼼꼼히 읽어볼 가치가 있다고 생각합니다.

그가 말한 것

Gist의 제목은 LLM Wiki: A pattern for building personal knowledge bases with LLMs입니다. 원본 링크:

https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

그의 출발점은 많은 사람이 공감하는 느낌입니다. “지식 베이스는 계속 커지지만, 실제로 쓸 수 있는 것은 점점 줄어든다.”

기사를 북마크하고, Notion에 독서 노트를 작성하고, Obsidian에 노트 더미를 쌓지만, 다음에 특정 지식이 필요할 때 찾을 확률은 높지 않습니다. 못 찾는 것이 아니라, 너무 분산되어 있고 연결이 없습니다. 찾더라도 조각조각이라 스스로 조립해야 합니다.

그는 이 문제를 기존 두 가지 해결책의 한계로 돌립니다.

첫째: 북마크 방식.
원문을 그대로 넣어두고 아무것도 하지 않으며, 전적으로 검색에 의존합니다. 문제는 검색이 문서를 찾아주지, 답을 찾아주지는 않는다는 점입니다. 여전히 읽고, 이해하고, 종합해야 합니다.

둘째: RAG 방식(Retrieval-Augmented Generation).
AI에 여러 문서를 제공하면 검색하여 즉석에서 답을 생성합니다. 북마크보다 훨씬 낫지만, 항상 임시방편이며 매번 처음부터 시작하므로 축적이 없습니다.

그가 제안한 LLM Wiki는 다른 아이디어입니다. 검색할 때 AI가 임시로 정리하게 하지 말고, 대신 AI가 계속 업데이트되는 위키를 유지하도록 하자는 것입니다.

LLM Wiki 작동 방식

전체 아키텍처는 세 개의 레이어로 구성됩니다.

원자료(Raw Sources)
평소에 읽는 것들: 기사, 책, 영상 자막, 회의 노트. 이것들은 가공되지 않은 원재료로서 그대로 저장됩니다.

위키(Wiki)
Markdown 파일들의 모음으로, 각 파일은 하나의 주제, 개념, 또는 개체에 해당합니다. 예를 들어 “머신러닝 - 과적합” 페이지, “독서노트 - 게임에 몰입하다” 페이지, “인물 - 파인만” 페이지가 있을 수 있습니다.

이 파일들은 여러분이 작성하는 것이 아닙니다. AI가 작성하고 지속적으로 유지보수합니다. 새 자료가 들어올 때마다 AI가 관련 페이지를 업데이트하고, 페이지 간 상호참조(cross-reference)를 설정하며, 모순이 생기면 표시합니다.

스키마(Schema)
“이 위키가 어떻게 생겨야 하는지"를 AI에 알려주는 설정입니다. 예를 들어 각 노트에 포함해야 할 필드, 정리 방식, 고립된 노트(orphan note)의 기준, 별도 페이지가 필요한 개념 등입니다.

그리고 세 가지 핵심 작업:

수집(Ingest)
새 자료가 들어올 때마다 AI가 읽고 10~15개의 위키 페이지를 업데이트합니다. 단순히 새 페이지를 만드는 것이 아니라, 기존 내용을 업데이트하고, 상호참조를 추가하며, 추가 확인이 필요한 부분을 표시합니다.

질의(Query)
질문을 하면 AI가 위키에서 답을 종합합니다. 핵심은: 질의 자체가 가치 있는 새로운 통합을 만들어내면, AI가 그것을 다시 위키에 기록한다는 점입니다. 즉, 사용할수록 위키가 더 풍부해집니다.

린트(Lint)
그가 특별히 언급한 작업으로, 이 계획에서 가장 영리한 부분이라고 생각합니다. AI가 정기적으로 전체 위키의 건강 상태를 점검합니다:

서로 모순되는 내용을 가진 두 페이지가 있는가?
오래된 진술이 있는가?
다른 페이지에서 링크되지 않은 고립 페이지(orphan page)가 있는가?
명백히 누락된 상호참조가 있는가?

이런 작업을 수동으로 하려면 지루하고 거의 지속하기 어렵습니다. 하지만 AI에게는 순수한 잡일(grunt work)일 뿐입니다.

역할 분담은 다음과 같습니다.

인간의 역할: 선별(curation, 무엇을 포함할지 선택), 비판적 판단(이 결론이 올바른가?), 감독(정기적으로 AI 업데이트 검토)
AI의 역할: 부기(bookkeeping)—상호참조, 일관성 유지, 고립 노드 정리, 포맷팅

그가 사용한 용어: 부기(bookkeeping). 이 단어는 잘 선택되었습니다. AI가 여러분을 대신해 생각하게 하는 것이 아니라, 해야 한다는 것을 알면서도 계속 미루는 유지보수 작업을 AI에 넘기는 것입니다.

옵시디언 사용자가 특히 주목해야 할 이유

최근에 프로그래밍 커뮤니티의 친구들 중 예전에는 Obsidian에 관심 없던 사람들이 하나둘씩 사용하기 시작한 것을 발견했습니다.

이유를 물으면 대답이 거의 같습니다: AI와 함께 사용하기에 너무 적합해서. 로컬 파일, 평문 Markdown, 종속성 없음—이전에는 마니아들의 선호였지만, 이제는 장점이 되었습니다. Claude Code 같은 도구는 추가 설정 없이 Obsidian Vault를 직접 읽고 쓸 수 있으며, AI가 할 수 있는 것을 바로 할 수 있습니다.

어떤 면에서 카파시의 Gist는 이를 더 명확히 해줍니다.

저도 한동안 Obsidian을 사용해왔는데, 이 Gist를 읽고 강한 느낌이 들었습니다.

그가 설명한 위키는 본질적으로 AI가 능동적으로 유지보수하는 Obsidian Vault입니다.

생각해보세요: Obsidian의 핵심은 무엇인가요? 양방향 링크로 연결된 로컬 Markdown 파일들입니다.

LLM Wiki의 핵심은 무엇인가요? Markdown 파일들과, 링크 생성 및 유지, 내용 통합, 건강 상태 점검을 도와주는 AI입니다.

기반 매체가 정확히 동일합니다. Obsidian Vault는 LLM Wiki의 가장 자연스러운 구현체라고 할 수 있습니다.

지금 수동으로 하는 작업들—노트에 양방향 링크 만들기, MOC(Maps of Content) 작성, 정기적인 정리 및 아카이빙—이 중 상당 부분을 AI가 LLM Wiki 설계에서 “부기 작업"으로 수행할 수 있습니다.

제 예를 들어보겠습니다: 글을写完 후 양방향 링크를 생성하고 정리하는 단계는 이제 Skill이 처리합니다. AI가 제 노트 보관함을 스캔하여 관련 글을 찾고 자동으로 양방향 링크를 추가합니다. 예전에는 이 단계를 매번 미뤘지만, 이제는 거의 신경 쓰지 않습니다.

카파시의 LLM Wiki는 이를 더 발전시킵니다. 글写完 후 한 번 실행하는 것이 아니라, 전체 지식 베이스를 지속적으로 유지보수되는 상태로 두고, Ingest, Query, Lint를 모두 자동화합니다.

물론 이 접근법에 문제가 있다고 보는 의견도 있습니다.

기술 커뮤니티에서는 일부가 젯텔카스텐(Zettelkasten)과 비교했습니다. 전통적인 젯텔카스텐은 능동적으로 노트를 작성하는 행위 자체가 이해의 과정이라고 강조합니다—수집이 아니라, 쓰기를 통해 연결을 구축하는 것입니다. AI가 요약하고 연관성을 만들어준다면, 그 이해 과정이 사라지는 것 아닐까요? 깔끔한 지식 베이스는 얻지만, 머릿속에는 아무것도 남지 않는 걸까요?

이것은 진짜 질문이며, 정답은 없다고 생각합니다.

하지만 Obsidian 사용자로서 제 판단은: 이 두 가지는 모순되지 않습니다. 단, 어떤 작업이 “진정한 사고가 필요한 작업"이고 어떤 작업이 “짜증 나는 부기 작업"인지 명확히 구분한다면 말이죠.

예를 들어:

기사를 읽고 핵심 아이디어를 추출하고 자신의 느낌과 생각을 쓰는 것 → 이것은 사고, 스스로 해야 함
3개월 동안 링크되지 않은 노트가 있는지 확인하는 것 → 이것은 부기, AI에 맡겨도 전혀 문제없음
어떤 개념 아래 여러 출처를 종합하는 것 → AI가 초안을 작성하고, 사용자가 검토
여러 노트의 프론트매터(frontmatter) 필드를 유지보수하는 것 → 순수 잡일, AI가 처리

진짜 위험은 AI를 사용해서 생각을 멈추는 것이 아니라, “AI가 이 기사를 요약한 것"과 “내가 이 기사를 읽었다"는 것을 동일시하는 데 있습니다.

이것만 구분할 수 있다면, LLM Wiki 접근법은 Obsidian 사용자에게 상당히 가치 있는 확장입니다.

다음 단계

카파시의 Gist는 현재 “좋은 패턴을 제안했지만, 즉시 사용할 수 있는 도구를 제공하지는 않은” 상태입니다.

커뮤니티에서 몇몇 사람들이 다양한 방향으로 이 아이디어를 구현하기 시작했지만, 아직 초기 단계입니다.

저는 제 설정을 본격적으로 업그레이드할 계획입니다. 먼저 Obsidian 노트 보관함을 LLM Wiki 방식으로 재구성한 다음, 기존의 양방향 링크 Skill을 더 발전시켜 Ingest와 Lint 로직을 추가하여 더 완전한 Skill로 만들려고 합니다.

Claude Code + Obsidian Vault를 사용하여 처음부터 끝까지 전체 과정을 실행해볼 것입니다—무엇이 잘 통하는지, 함정은 무엇인지, 무엇을 재설계해야 하는지 알아보기 위해서요. 잘 작동하면 전체를 패키지화하여 공유할 예정입니다. 그러면 다른 사람들이 처음부터 구축할 필요 없이 바로 사용할 수 있게 됩니다.

다음 장에서 이 실습 과정을 다룰 것입니다.

요약

오늘 배운 내용:

카파시는 스탠포드 출신의 딥러닝 연구자로, 테슬라 오토파일럿의 순수 비전 접근법을 이끌었고, 오픈AI의 공동 창업자이며, 현재 AI 교육에 집중하고 있습니다.
LLM Wiki는 “AI가 지식 베이스를 능동적으로 유지보수하는” 패턴으로, RAG의 수동적 검색과 대조됩니다.
핵심 아키텍처는 세 개의 레이어: 원자료 → 위키(Markdown 파일 모음) → 스키마(구조 정의).
세 가지 작업: 수집(Ingest, 수집 및 업데이트) / 질의(Query, 질의 및 기록) / 린트(Lint, 건강 상태 점검).
핵심 역할 분담: 인간은 선별과 판단, AI는 “부기”—상호참조, 일관성 유지, 고립 노드 정리.

핵심 포인트:

Obsidian Vault는 그 자체로 Markdown 파일 모음이며, LLM Wiki의 매체와 매우 일치하여 거의 가장 자연스러운 구현체입니다.
지금 수동으로 만드는 양방향 링크와 MOC는 바로 LLM Wiki에서 AI가 자동으로 유지하는 상호참조입니다.
“AI가 생각을 대신한다"는 걱정은 일리가 있지만, 그것과 AI가 “부기"를 하는 것은 다릅니다—혼동하지 마세요.
이 패턴은 현재 즉시 사용 가능한 도구가 없으며, 직접 구축해야 합니다.
다음 장에서는 실습 구현 과정을 다룰 것입니다. 잘 작동하면 Skill로 패키지화하여 공유하겠습니다.

커스텀 CSS: Obsidian을 나만의 공간으로 만들기

Mon, 01 Jan 0001 00:00:00 +0000

이전에 테마 설정에 대해 다뤘고, 테마를 설치하면 Obsidian이 훨씬 좋아 보입니다. 하지만 많은 사람들이 여전히 테마를 바꾼 후에도 뭔가 어색함을 느낍니다—글꼴이 너무 작거나, 줄 간격이 너무 좁거나, 노트 영역이 너무 좁거나… 이러한 세부 사항은 테마의 범위를 벗어납니다. 이 장에서는 CSS Snippets으로 미세 조정하는 방법을 다룹니다.

이 장에서는 네 가지를 다룹니다:

CSS가 무엇인지—코딩 지식이 없어도 이해할 수 있게
테마가 있어도 왜 CSS가 필요한지
AI가 CSS를 대신 작성하게 하세요—복사해서 붙여넣기만 하면 됩니다
CSS를 어디에 두고 어떻게 활성화하는지

CSS란 무엇인가

CSS는 Cascading Style Sheets의 약자입니다. 기술적으로 들리지만 핵심 논리는 간단합니다: CSS는 모양을 제어하는 규칙의 집합입니다.

예를 들어:

이 텍스트의 글꼴, 크기, 색상은 무엇인가?
이 영역의 너비는 얼마인가? 여백은?
마우스를 올렸을 때 배경색은 무엇인가?

웹페이지에서 보는 거의 모든 시각적 효과는 CSS로 제어됩니다. Obsidian의 인터페이스도 웹 기술(Electron)로 구축되었으므로 CSS를 사용하여 모양을 제어할 수 있습니다.

설치하는 테마는 본질적으로 다른 사람이 작성한 대규모 CSS 패키지입니다. CSS Snippet은 테마가 다루지 않는 부분을 미세 조정하기 위해 직접 추가하는 작은 CSS 조각입니다.

테마는 전체 스타일이고, 스니펫은 국소적인 조정입니다. 서로 충돌하지 않으며 함께 사용할 수 있습니다.

테마가 있는데 왜 여전히 CSS가 필요한가?

테마는 “전체 스타일” 문제를 해결하지만, 많은 개인 취향 세부 사항은 테마의 범위를 벗어납니다—그리고 그래야만 합니다. 모든 사람의 취향이 다르기 때문입니다.

테마가 부족한 몇 가지 일반적인 상황:

노트 영역이 너무 좁음: 많은 테마가 기본적으로 노트의 최대 너비를 제한하여, 넓은 화면에서 큰 빈 공간이 남고 내용이 중앙에 좁게 표시됩니다. 어떤 사람은 이 레이아웃을 좋아하고, 다른 사람은 낭비라고 생각합니다.

줄 간격이 너무 좁거나 너무 넓음: 기본 줄 간격이 편하지 않을 수 있지만, 테마에는 이에 대한 옵션이 없습니다.

제목 색상이 마음에 들지 않음: 테마는 전반적으로 마음에 들지만 H1 색상이 너무 밝아서 어둡게 하고 싶습니다.

성가신 UI 요소: 예를 들어, 사용하지 않는 버튼을 숨기고 싶습니다.

이러한 요구는 매우 구체적이고 개인적입니다. CSS Snippet은 이러한 “마지막 마일” 문제를 해결하기 위해 설계된 도구입니다.

직접 작성할 필요 없음—AI가 대신 작성하게 하세요

이 장에서 가장 중요한 점입니다: CSS를 전혀 배울 필요가 없습니다—AI가 대신 작성하게 하면 됩니다.

과정은 매우 간단합니다: AI에게 변경하고 싶은 내용을 말하기만 하면 됩니다:

“Obsidian CSS Snippet을 작성해줘: 노트 내용 영역의 최대 너비를 900px로 설정”

“Obsidian CSS Snippet을 작성해줘: 본문 줄 간격을 1.8로 설정”

“Obsidian CSS Snippet을 작성해줘: H1 색상을 진한 파란색으로 변경”

AI는 완전한 CSS 코드 조각을 제공하며, 복사해서 바로 사용할 수 있습니다.

AI에서 더 나은 결과를 얻기 위한 몇 가지 팁:

Obsidian CSS Snippet이라고 명시하세요, 그렇지 않으면 AI가 잘못된 변수 이름을 가진 일반 웹 CSS를 줄 수 있습니다.
AI에게 주석을 추가하라고 요청하세요, “각 속성 옆에 무엇을 하는지 설명하는 주석을 추가해줘"라고 말하면 나중에 파일을 이해할 수 있습니다.
한 번에 하나씩 변경하세요, 하나의 스니펫 파일에 하나의 작업만—디버깅이 쉽고 개별적으로 끌 수 있습니다.

예시 대화:

Me: Write me an Obsidian CSS Snippet to set the maximum width of the note content area to 900px, please add comments.

AI:
.markdown-source-view, .markdown-reading-view {
  /* Limit the maximum width of the note content area */
  --file-line-width: 900px;
}

이게 전부입니다. CSS 구문을 이해할 필요도, 문서를 찾아볼 필요도 없습니다. 원하는 것을 설명하고, 코드를 받고, 붙여넣고, 끝입니다.

CSS를 어디에 두나요? 어떻게 활성화하나요?

CSS Snippet은 고정된 저장 위치가 있습니다. 다음 단계를 따르기만 하면 됩니다.

1단계: 스니펫 폴더 찾기

경로: 볼트 루트 → .obsidian 폴더 → snippets 폴더

.obsidian은 숨김 폴더입니다. Mac에서는 Command + Shift + .를 눌러 숨김 파일을 표시합니다. snippets 폴더가 없으면 수동으로 만드세요.

물론 설정에서 직접 접근할 수도 있습니다.

2단계: .css 파일 만들기

snippets 폴더에 새 텍스트 파일을 만들고 확장자를 .css로 변경합니다. 이름은 원하는 대로 지정하되, note-width.css나 line-height.css처럼 설명적인 이름을 사용하는 것이 좋습니다. AI의 코드를 붙여넣고 저장합니다.

또는 이 폴더를 열고 AI가 직접 CSS 파일을 여기에 작성하게 할 수도 있습니다.

3단계: Obsidian에서 활성화하기

경로: 설정 → 외형 → CSS snippets

페이지 하단으로 스크롤하면 “CSS snippets” 섹션이 보입니다. 오른쪽의 새로고침 아이콘을 클릭하면 방금 만든 파일이 목록에 나타납니다. 파일 이름 옆의 토글을 클릭하면 토글 색상이 바뀌고 스니펫이 적용됩니다. 인터페이스가 즉시 변경되며 재시작이 필요 없습니다. 효과가 맞지 않으면 토글을 끄고 코드를 다시 확인하세요.

내가 CSS를 사용하는 방법

참고를 위해 실제로 사용하는 몇 가지 스니펫을 소개합니다.

노트 영역 넓히기 – 가장 많이 사용하는 스니펫입니다. 노트 내용 영역의 최대 너비를 더 넓게 설정하여 큰 화면에서 여백을 줄입니다.

줄 간격 조정 – 기본 줄 간격이 저에게는 약간 좁아서 CSS로 약간 늘려 더 편안하게 읽을 수 있게 합니다.

사용하지 않는 요소 숨기기 – Obsidian 인터페이스에 사용하지 않는 버튼과 아이콘이 있습니다. CSS로 display: none으로 설정하여 숨겨 인터페이스를 더 깔끔하게 만듭니다.

Callout 스타일 조정 – 특정 테마의 callout 블록 기본 색상이 마음에 들지 않아 CSS로 더 부드러운 색상으로 변경했습니다.

이 네 가지 스니펫은 각각 별도의 .css 파일에 저장되어 있으며, 각각 개별적으로 토글할 수 있습니다. 시간이 지나 어떤 것이 맞지 않으면 그냥 끄면 됩니다—서로 간섭하지 않습니다.

요약

오늘 배운 내용:

CSS는 인터페이스 모양을 제어하는 규칙이며, Obsidian은 CSS Snippet을 사용하여 국소적인 조정을 합니다.
테마는 전체 스타일이고, 스니펫은 세부 조정입니다—함께 작동합니다.
CSS를 직접 작성할 필요 없이 AI에게 변경할 내용을 말하고 코드를 복사하세요.
스니펫 저장 경로: 볼트 루트 → .obsidian/snippets/ → .css 파일.
설정 → 외형 → CSS snippets에서 활성화하고 토글을 켜면 적용됩니다.

핵심 요점:

AI에게 요구사항을 설명하여 CSS를 작성하게 하는 것이 CSS 구문을 직접 배우는 것보다 훨씬 효율적입니다.
하나의 스니펫은 하나의 작업만 수행하여 관리와 디버깅이 쉽습니다.
토글은 언제든지 끌 수 있어 안전하고 되돌릴 수 있으므로 인터페이스를 망칠 걱정이 없습니다.

폴더 구조: 로컬 Zettelkasten 워크플로우

Mon, 01 Jan 0001 00:00:00 +0000

일기 플러그인(음성 입력으로 장벽을 낮추고 축적된 항목을 AI에 보내 검토)을 다룬 후, 이 장에서는 Obsidian을 설치한 후 흔히 부딪히는 장애물인 폴더 구성 방법을 다룹니다.

폴더 구조를 계획해야 하는 이유

계획 없이 시작하면 일반적으로 이런 결과가 나타납니다: Obsidian을 사용하기 시작할 때 ‘업무’, ‘공부’, ‘독서’, ‘임시’ 같은 폴더를 대충 만듭니다. 점점 더 많이 만들다 보면 어디에 무엇을 넣었는지 기억나지 않아 매번 검색하게 되고, 결국 폴더는 쓸모없게 됩니다.

또는 다른 극단으로 가서 ‘업무/프로젝트 A/회의록/2026/1분기’ 같은 계층 구조를 설계하는 데 많은 시간을 쏟습니다. 세심하게 계획했지만 두 달 후 유지 비용이 너무 높다는 것을 깨닫습니다. 새 항목을 어디에 넣어야 할지 모르고 결국 모든 것이 루트 디렉토리에 쌓입니다.

폴더 계획의 목표는 보관함을 깔끔하게 보이게 하는 것이 아니라 저장과 검색을 모두 원활하게 하는 것입니다.

널리 알려진 방법 개요

제 방법을 소개하기 전에, 두 가지 잘 알려진 방법을 간략히 살펴보겠습니다. 그냥 이런 방법이 있다는 정도로 알아두세요.

PARA

PARA는 생산성 블로거 Tiago Forte의 방법으로, 네 개의 폴더로 구성됩니다: Projects(진행 중인 프로젝트), Areas(장기 책임), Resources(참고 자료), Archives(보관소).

논리는 명확하고 꽤 인기가 있습니다. 문제는 경계가 모호하다는 점입니다. 어떤 항목이 Areas에 속하는지 Resources에 속하는지 확신하기 어려운 경우가 많습니다. 분류하는 데 시간이 걸리고, 시간이 지나면 포기하기 쉽습니다.

Zettelkasten

독일 사회학자 Niklas Luhmann이 고안한 방법으로, 핵심 아이디어는 각 노트가 하나의 아이디어를 담고, 번호로 식별되며, 링크를 통해 연결되어 네트워크를 형성한다는 것입니다. 폴더 분류에 의존하지 않고 노트 간 연결에 의존합니다.

깊은 지식 축적에는 훌륭하지만, 진입 장벽이 높고 유지 비용도 낮지 않습니다. 일상 워크플로우의 주요 프레임워크로는 적합하지 않습니다.

제 접근법: 5개 폴더 + 1가지 규칙

그렇게 복잡할 필요 없습니다. 제가 충분하고 유지하기 쉽다고 생각하는 구조는 다음과 같습니다.

폴더 구조

00-Inbox/
01-Notes/
02-Templates/
04-Output/
07-Diary/

필요에 따라 ‘08-리모델링’이나 ‘09-영어 학습’ 같은 프로젝트 폴더를 만들고, 완료되면 보관하거나 삭제할 수 있습니다.

00-Inbox: 모든 것은 먼저 여기로

이것은 전체 시스템의 진입점입니다.

브라우저 클리핑, 음성으로 기록한 아이디어, 무작위 메모, 처리되지 않은 자료—무엇이든 일단 인박스에 던져 넣으세요.

수집할 때 분류하는 데 시간을 쓰지 마세요. 일단 넣고 보세요. 인박스의 가치는 기록의 마찰을 줄이는 데 있습니다. ‘이걸 어디에 넣지?‘라고 생각할 필요 없이 그냥 넣으면 됩니다.

하지만 인박스에는 황금률이 있습니다: 들어온 것은 정기적으로 처리해야 한다는 것입니다.

며칠에 한 번(또는 매주) 인박스를 살펴보고 항목을 적절한 곳으로 정리하세요. 노트는 노트 폴더로, 불필요한 것은 삭제하고, 글로 만들 것은 출력 폴더로 옮깁니다.

인박스는 창고가 아닙니다. 무한정 쌓아둘 수 없습니다. 3개월 전 항목이 아직 인박스에 남아 있다면, 이 워크플로우가 제대로 작동하지 않고 있다는 뜻입니다.

01-Notes: 분류 없음, 평면 구조

이것이 이 전체 시스템에서 전통적인 접근법과 가장 큰 차이점입니다.

노트 폴더에는 하위 폴더를 만들지 않고 모든 노트를 한 층에 평평하게 배치합니다.

책 노트, 회의록, 배운 개념, 아이디어의 확장—모두 함께, 주제별 구분 없이, 시간 순서 없이, 그냥 하나의 큰 평면 층입니다.

왜 이렇게 할까요?

AI 시대에는 검색이 분류보다 중요하기 때문입니다. 노트를 ‘경제학/거시/통화정책’ 아래에 두든 루트 디렉토리에 두든 AI 검색에는 차이가 없습니다. AI는 폴더 경로가 아니라 내용을 이해하여 찾습니다.

그리고 수동 분류에 쓰는 시간은 순수한 유지 비용입니다. 어디에 넣을지 생각하고, 어디에 넣었는지 기억하고, 나중에 찾지 못하는 데 드는 시간입니다.

평면 구조에서는 검색에 의존합니다. AI는 전체 텍스트 검색을 할 수 있으며, 이는 ‘아마 그 하위 폴더 어딘가에 있을 거야’라고 기억하는 것보다 훨씬 신뢰할 수 있습니다.

04-Output: 외부 독자를 위한 콘텐츠

이 폴더에는 외부 독자를 위해 작성한 콘텐츠를 보관합니다: 위챗 공개 계정 글, 블로그 포스트, 공식 보고서, 다른 사람을 위해 정리한 문서.

노트 폴더와의 차이점은 대상입니다. 노트는 자신을 위한 것이며 완전하거나 예쁠 필요 없이 기록만 하면 됩니다. 출력은 다른 사람이 보거나 보존하고 싶은 완성된 콘텐츠입니다.

분리하면 장점이 있습니다: 출력 폴더를 열면 초안이나 조각에 방해받지 않고 비교적 완성된 콘텐츠를 볼 수 있습니다.

07-Diary: 분리, 노트와 섞지 않음

일기는 별도 폴더에 보관합니다.

일기 항목은 날짜별로 생성되는 파일이며, 그 수는 시간이 지남에 따라 선형적으로 증가합니다. 앞서 언급했듯이, 일기 플러그인에서 저장 경로를 설정하여 한 곳에 모아두는 것이 좋습니다.

노트와 분리하는 이유는 간단합니다: 일기의 사용 사례는 노트와 다릅니다. 일기는 시간 순서로 탐색하고, 노트는 키워드로 검색합니다. 섞으면 서로 방해가 됩니다.

프로젝트 폴더: 필요할 때 만들고, 완료되면 보관

리모델링, 이직, 기술 학습—명확한 시간 경계가 있는 일은 자체 폴더를 만들어 관련 파일을 모두 모아 중앙에서 쉽게 볼 수 있습니다.

프로젝트가 완료된 후에는 폴더를 보관하거나 삭제하세요. 영원히 공간을 차지하게 두지 말고 또 다른 잡동사니 더미가 되지 않게 하세요.

AI 시대에 평면 구조가 더 나은 이유

전통적인 폴더 분류 논리는 ‘수동 탐색’에 기반합니다. 폴더 구조가 있어야 항목의 위치를 기억할 수 있으므로 분류하고 계층을 만듭니다.

하지만 이제는 다릅니다.

Obsidian의 전체 텍스트 검색 + AI의 의미 이해는 이미 대부분의 ‘찾기’ 시나리오를 커버할 수 있습니다. 노트의 파일 이름은 기억나지 않을 수 있지만, 대략 어떤 내용인지는 기억합니다. 그것으로 충분합니다. 몇 가지 키워드를 검색하거나 AI가 찾도록 하면 됩니다.

이러한 전제 하에, 세밀한 분류의 한계 이익은 매우 작아지지만 유지 비용은 그대로입니다.

폴더 구조가 복잡할수록 다음과 같은 의미가 있습니다:

항목을 넣을 때 한 번 더 생각해야 합니다(이건 어디에 넣지?)
시간이 지나면 어디에 넣었는지 잊어버립니다
시스템이 일관성을 잃고 일부 항목이 구조 밖에 떠다니게 됩니다

반대로, 구조가 단순할수록 유지 비용이 낮아지고 지속할 가능성이 높아집니다. 일관되게 작동하는 단순한 시스템이 중간에 포기한 정교한 시스템보다 훨씬 가치 있습니다.

요약

오늘 다룬 내용:

폴더 계획의 핵심 목적: 저장과 검색을 모두 원활하게 하는 것, 보기 좋게 하기 위한 것이 아님
알아둘 인기 방법: PARA와 Zettelkasten은 각각 사용 사례가 있지만 일반 사용자에게 유지 비용이 높음
제 접근법: 5개 폴더 + 1가지 규칙:
- 00-Inbox: 모든 것은 먼저 여기로, 정기적으로 처리
- 01-Notes: 평면 구조, 분류 없음
- 04-Output: 외부 독자를 위한 완성된 콘텐츠
- 07-Diary: 분리, 노트와 섞지 않음
- 프로젝트 폴더: 필요할 때 만들고, 완료되면 보관
인박스의 황금률: 들어온 것은 정기적으로 처리해야 하며, 무한 축적 금지

핵심 포인트:

AI 시대에는 검색이 분류보다 중요—노트를 평평하게 두고 AI가 찾게 하세요. 수동 계층 유지보다 효율적입니다.
시스템이 단순할수록 지속하기 쉽다—작동하는 단순한 구조가 정교하지만 포기한 구조보다 낫습니다.
인박스는 진입점이지 창고가 아니다—정기적으로 비워야 전체 워크플로우가 작동합니다.