에디블로그
Engineer's Field Notes

AI 자동화로 매일
한 편씩 쓰는
엔지니어 운영 노트

Claude Code · 자동화 파이프라인 · 사고 회고까지. 잘 굴러간 기록 + 깨진 흔적도 같이 남깁니다.

사람이 할 수 있는 일은,
AI도 할 수 있어야 합니다.
매일 한 편 쓰면서 검증 중.
— 이번 주 가장 많이 읽힌 글 TOP 3
개발자 도구/노트 & 지식관리

[Obsidian] 내 디스크에 쌓는 마크다운 지식관리

반응형
[Obsidian] 내 디스크에 쌓는 마크다운 지식관리
개발자 도구 · 노트 & 지식관리

[Obsidian] 내 디스크에 쌓는 마크다운 지식관리

Obsidian은 노트를 클라우드 서버가 아니라 내 컴퓨터의 마크다운 파일로 저장하는 노트 앱입니다. Notion·Evernote처럼 서비스에 갇히지 않고, 노트끼리 링크로 엮어 개인 위키를 만드는 데 쓰입니다. 이 글에서는 무엇을 대체하는지, 첫 vault를 만드는 법, 핵심 기능 세 가지와 코어 플러그인, 그리고 시작 전에 알아두면 좋은 점을 정리합니다.

노트를 클라우드가 아니라 내 폴더에 둡니다

Obsidian의 가장 큰 특징은 저장 방식입니다. 작성한 노트는 전부 내 디스크의 일반 마크다운(.md) 파일로 남습니다. 이 노트들이 들어있는 폴더를 Obsidian에서는 vault(금고)라고 부릅니다. vault는 그냥 평범한 폴더라서, Obsidian을 켜지 않아도 탐색기나 다른 텍스트 에디터로 열어볼 수 있습니다.

이 점이 Notion이나 Evernote 같은 클라우드 노트와 다릅니다. 그쪽은 데이터가 회사 서버의 데이터베이스에 들어가고, 내보내기를 해야 파일로 받을 수 있습니다. Obsidian은 처음부터 파일이 결과물이라, 서비스가 종료돼도 노트는 그대로 폴더에 남습니다. 공식 홈페이지가 "내 생각을 기기에 비공개로 저장한다"를 전면에 내세우는 이유입니다.

구분 Obsidian 클라우드 노트(Notion 등)
저장 위치 내 디스크의 .md 파일 서비스 서버 DB
오프라인 기본 동작 제한적
파일 소유 폴더째 내 것 내보내기 필요
동기화 유료 Sync 또는 직접 구성 기본 제공
개인 사용 비용 무료 무료~유료 혼합

대신 트레이드오프가 있습니다. 클라우드 노트가 기본으로 주는 자동 동기화·실시간 협업이 Obsidian에서는 별도 설정이거나 유료입니다. 이 부분은 뒤에서 다시 짚습니다.

설치하고 첫 vault 만들기

시작 절차는 단순합니다. 공식 사이트에서 앱을 받아 설치한 뒤, 노트를 담을 vault를 하나 만들면 끝입니다. 공식 문서가 안내하는 순서도 이렇습니다.

  1. Obsidian을 다운로드하고 설치합니다.
  2. vault를 새로 만듭니다(노트를 저장할 빈 폴더를 지정).
  3. 첫 노트를 만듭니다.
  4. 노트끼리 링크로 연결합니다.
  5. 기존 마크다운 노트가 있으면 가져옵니다.
  6. (선택) 여러 기기에 동기화합니다.

"vault를 만든다"는 건 거창한 게 아니라, 노트를 모아둘 폴더 하나를 정하는 일입니다. 빈 폴더를 새로 지정해도 되고, 이미 .md 파일이 들어있는 폴더를 vault로 열어도 됩니다. 여러 vault를 만들어 업무용·개인용을 분리하는 식으로도 씁니다.

노트를 연결하는 세 가지 기능

Obsidian을 단순한 마크다운 에디터와 구분 짓는 건 노트를 엮는 방식입니다. 핵심은 세 가지입니다.

위키링크 — 대괄호 두 개로 노트를 잇는다

본문에 [[노트제목]] 형식으로 적으면 다른 노트로 연결됩니다. 아직 없는 제목을 적으면 그 자리에서 새 노트를 만들 수 있습니다. 일반 마크다운 링크처럼 경로를 적을 필요 없이 노트 이름만으로 연결돼서, 생각의 흐름대로 빠르게 엮을 수 있습니다.

백링크 — 나를 가리키는 노트가 자동으로 모인다

A 노트에서 B를 링크하면, B 노트를 열었을 때 "A가 나를 링크했다"는 정보가 백링크 패널에 자동으로 표시됩니다. 따로 정리하지 않아도 한 주제와 연결된 노트들이 역으로 모입니다. 어떤 개념이 다른 노트들에서 어떻게 언급됐는지 한눈에 보입니다.

그래프 뷰 — 노트 사이 연결을 점과 선으로 본다

vault 전체의 노트를 점으로, 링크를 선으로 그려 보여주는 화면입니다. 어떤 노트가 많이 연결됐는지, 외따로 떨어진 노트는 무엇인지 시각적으로 파악할 수 있습니다. 지식이 쌓일수록 군집이 생기는 걸 눈으로 확인하는 용도라, 정리 상태를 점검할 때 참고하는 기능입니다.

코어 플러그인부터 익히면 됩니다

Obsidian은 기능 상당수가 플러그인으로 켜고 끄는 구조입니다. 그중 설치하면 기본 내장돼 있는 것이 코어 플러그인입니다. 외부에서 따로 받지 않아도 설정에서 켜기만 하면 되는 것들이라, 처음엔 이쪽부터 익히는 편이 좋습니다. 자주 쓰이는 코어 플러그인은 이렇습니다.

  • 데일리 노트(Daily notes) — 오늘 날짜의 노트를 한 번에 생성. 일지·메모 누적에 씁니다.
  • 템플릿(Templates) — 정해둔 양식을 노트에 삽입. 회의록·독서 노트 틀을 재사용합니다.
  • 백링크(Backlinks) — 위에서 설명한 역링크 패널.
  • 아웃라인(Outline) — 제목 단계를 목차로 띄워 긴 노트를 탐색.
  • 명령 팔레트(Command palette) — 단축키로 모든 명령을 검색해 실행.

실제 노트가 어떤 모습인지 보면 감이 잡힙니다. 마크다운 파일 위쪽에 메타데이터(프론트매터)를 두고, 본문에서 위키링크와 태그로 다른 노트를 엮는 식입니다.

---
title: Kafka 컨슈머 그룹 정리
tags: [kafka, backend]
created: 2026-06-06
---

# 컨슈머 그룹

오프셋 관리는 [[Kafka 오프셋]] 노트 참고.
리밸런싱은 [[컨슈머 리밸런싱]]에서 이어서 정리.

관련 주제: #메시징 #분산시스템

이렇게 적어두면 [[Kafka 오프셋]]은 클릭 한 번으로 이동하고, 그 노트를 열면 백링크에 이 문서가 잡힙니다. #kafka 태그로는 같은 태그가 붙은 노트를 한 번에 모아볼 수 있습니다.

커뮤니티 플러그인과 Canvas로 확장합니다

코어 기능으로 부족하면 커뮤니티 플러그인을 더합니다. 공식적으로 수천 개가 공개돼 있고, 앱 안에서 검색·설치합니다. 많이 알려진 것으로는 표 형태로 노트를 쿼리하는 Dataview, 칸반 보드를 만드는 Kanban, 할 일을 모아 관리하는 Tasks, 달력을 띄우는 Calendar 등이 있습니다.

Canvas는 무한 캔버스 기능입니다. 노트·이미지·카드를 넓은 화면에 자유롭게 배치하고 선으로 연결해, 브레인스토밍이나 구조 잡기에 씁니다. 글로 쓰는 노트와 별개로, 생각을 공간에 펼쳐 정리하고 싶을 때 쓰는 도구입니다.

시작 전에 알아두면 좋은 점

기본 앱은 개인 사용에 무료입니다("제한 없이 무료, 가입 불필요"가 공식 문구). 다만 알아둘 비용과 함정이 있습니다.

  • 동기화는 유료이거나 직접 구성 — 공식 Obsidian Sync는 연 결제 기준 사용자당 월 $4(월 결제 $5)입니다. 비용을 피하려면 vault 폴더를 iCloud·Dropbox 같은 클라우드 폴더에 두고 동기화하는 방식을 직접 구성할 수 있는데, 충돌 처리는 본인 몫이 됩니다.
  • 웹 공개는 별도 Publish — 노트를 사이트로 공개하는 Obsidian Publish는 사이트당 월 $8(월 결제 $10)입니다.
  • 업무용은 상용 라이선스 — 회사 업무에 쓰면 사용자당 연 $50의 상용 라이선스가 필요합니다. 개인 용도는 무료입니다.
  • 플러그인 품질 편차 — 커뮤니티 플러그인은 개인 개발자가 만든 것이 많아, 업데이트 중단이나 호환성 문제가 생길 수 있습니다. 핵심 작업은 코어 기능 위주로 두는 편이 안전합니다.
  • 초기 자유도가 곧 진입장벽 — 폴더 구조·태그 체계·플러그인을 스스로 정해야 해서, 정해진 틀을 주는 노트 앱보다 처음 세팅에 손이 갑니다.

정리하면 Obsidian은 노트를 서비스가 아니라 파일로 소유하고 싶은 사람, 노트끼리 링크로 엮어 개인 지식 베이스를 만들려는 사람에게 맞습니다. 마크다운에 익숙한 개발자라면 기존 .md 메모를 그대로 vault로 열어 바로 시작할 수 있습니다. 처음에는 코어 플러그인 몇 개만 켜고 위키링크로 노트를 잇는 것부터 해보면, 구조는 쓰면서 천천히 잡아가면 됩니다.

설치 안내 공식 사이트(obsidian.md)에서 Windows·macOS·Linux 데스크톱 앱과 iOS·Android 모바일 앱을 받을 수 있습니다. 개인 사용은 무료이며 가입이 필요 없습니다. 첫 실행 시 vault로 쓸 폴더만 지정하면 바로 노트를 만들 수 있습니다.

이 글은 공식 문서·홈페이지·요금제 페이지를 근거로 한 객관 정리이며, 작성자의 직접 사용기가 아닙니다. 기능·가격은 시점에 따라 달라질 수 있으니 도입 전 공식 페이지에서 확인하시길 권합니다.

반응형

📚 같이 보면 좋은

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 일정액의 수수료를 제공받습니다."