Week 05 · AI 바이브 코딩

Obsidian + 팀 지식 위키

내 PC에 평생 가는 마크다운 지식창고를 만드는 주. 흩어진 회의록·자료·노트가 처음으로 한 곳에 모이고, 서로 [[링크]]로 연결됩니다.

📥 Obsidian 설치 📝 마크다운 노트 🔗 wikilink [[ ]] 🕸 그래프뷰 🗂 팀 위키 시작

되짚기 · 4주차에서

지난주에 스킬·MCP로 Claude를 확장했습니다

강력해진 Claude — 그런데 어디에 결과를 "쌓을지"가 빠져있죠.

~ 4주차까지

🧩 도구는 충분

스킬·MCP로 작업은 함
대화 끝나면 증발 — 흔적 없음

→

5주차 후

📚 흔적이 쌓인다

매번 대화 결과를 마크다운으로 저장
다음 주에 다시 꺼내 쓰는 자산

이번 주 빌드 — 미리보기

나만의 지식 데이터베이스가 쌓이면, 이런 화면이 됩니다

Vault — 팀 지식

📁 회의록

2026-05-21 주간회의

2026-05-27 AI팀 미팅

📁 자료

Claude API 기본

스킬·MCP 정리

📁 사람

최정우

📁 프로젝트

AI-Learning

# 2026-05-27 AI팀 미팅

참석: [[최정우]], [[김OO]]

이번 주가 끝나면…

1

Obsidian을 내 PC에 설치하고 첫 Vault를 만든다

2

마크다운 + [[ ]] 링크로 노트를 작성한다

3

그래프뷰로 흩어진 노트들의 연결을 본다

4

회의록·자료를 한 위치로 모아 팀 위키의 첫 5쪽을 채운다

문제 · 1~4주에 쌓인 자료

지금 여러분의 기록은 어디 있나요?

📧

메일·메신저

"그거 어디 봤더라" — 검색해도 안 나옴. 흐름 끊김.

📝

Word·한글 파일

폴더에 던져둠. 연결이 없음. 다음에 못 찾음.

📋

Notion·웹 도구

데이터가 남의 서버. 인터넷 끊기면 못 봄.

공통 문제 — 1) 검색 안 됨 · 2) 서로 연결 안 됨 · 3) Claude가 읽을 수 없음

해답 · Obsidian = 4가지의 조합

한 줄로 끝나는 Obsidian의 정의

📁 로컬 폴더 + 📝 마크다운 + 🔗 [[링크]] + 🕸 그래프뷰

LOCAL · 내 PC

📁 Vault = 그냥 폴더 하나

DB 없음. .md 파일 모음. 어디든 복사 가능, 평생 내 것.

MD · 마크다운

📝 텍스트 파일 (.md)

Word 없이도 어디서나 열림. 30년 뒤에도 열림. Claude도 읽음.

LINK · 연결

🔗 [[노트이름]]

노트끼리 클릭으로 점프. 같은 사람·프로젝트가 자동으로 묶임.

GRAPH · 시각

🕸 지식의 지도

노트가 늘수록 별자리처럼 보임. 빈 자리(연결 부족) 발견.

설치 1 · Windows + macOS

설치 — 3가지 방법 중 하나 (양쪽 OS 동일)

각 방법은 Windows와 macOS 명령만 다름. 5분이면 끝.

방법 ① · 권장

패키지 매니저 (한 줄)

# Windows · PowerShell
> winget install Obsidian.Obsidian

# macOS · Terminal
$ brew install --cask obsidian

자동 설치 + 자동 업데이트. brew 없으면 brew.sh 먼저.

방법 ② · 공식 사이트

브라우저에서 직접

# 양쪽 OS 같은 URL
https://obsidian.md/
download

→ Win: .exe 더블클릭
→ Mac: .dmg → Apps 폴더

명령줄 모를 때. 그냥 다운로드.

방법 ③ · Claude한테

자연어 폴백

> "내 PC에 Obsidian
설치해줘"

권한·Gatekeeper(Mac) 까지 Claude가 단계별 안내.

Mac만 한 번 더 — 첫 실행 시 "시스템 설정 → 개인정보보호 → 열기 허용" 클릭하면 끝.

설치 3 · 첫 Vault

Vault = 내 지식창고 폴더 한 개

Obsidian은 폴더 하나를 "Vault" 로 인식. 그 폴더 안 .md 파일이 곧 노트.

1️⃣ 첫 실행 시

Create new vault

초기 화면에서 "Create new vault" 클릭.

→

2️⃣ 이름 + 위치

팀위키 / D:\Obsidian

이름은 팀위키 추천. 위치는 동기화 폴더(Google Drive / iCloud / OneDrive)에 두면 백업 자동.

→

3️⃣ 완료

Open

빈 Vault 가 열림. 이제 노트를 만들 수 있음.

# 결과 — 내 PC 폴더 구조
D:\Obsidian\팀위키\
├── .obsidian\ # 설정 (자동 생성, 건드릴 일 없음)
└── # 여기에 .md 파일들이 쌓일 예정

첫 화면 · 인터페이스

화면 3등분으로 외워두기

① 파일 트리

📁 폴더

노트.md

또다른노트.md

← 좌측 사이드바
토글: Ctrl+\

② 에디터 · 본문

# 노트

여기가 본문 영역 — 마크다운으로 쓰면

실시간 미리보기가 함께 보임.

- 단축키 Ctrl+N → 새 노트

- 단축키 Ctrl+O → 노트 찾기

- 단축키 Ctrl+P → 명령 팔레트

③ 메타

백링크
아웃링크
태그

← 우측 패널
토글: Ctrl+Shift+\

왼쪽 = 파일 트리 · 가운데 = 에디터 · 오른쪽 = 메타정보(백링크 등). 끝.

기능 1 · 노트 작성

새 노트 = Ctrl+N · 끝

새 노트 만드는 3가지 방법

1

Ctrl+N (가장 빠름)

지금 보고 있는 폴더 안에 무제 노트 생성

2

좌측 트리 · 우클릭 → 새 노트

원하는 폴더에 만들 때

3

[[새이름]] 적으면서 자동 생성

본문에 [[회의록]] 적고 클릭하면 그 자리에서 노트 생김

예시 — 첫 노트

# 2026-05-27 첫 노트

## 오늘 배운 것
- Obsidian 설치 완료
- Vault = 폴더 한 개
- [[팀위키]] 라는 이름의 Vault

## 다음 할 일
- [ ] 회의록 한 장 만들기
- [ ] 그래프뷰 열어보기

#일지 #W5

파일명은 .md 자동. 제목(#)은 본문 첫줄, 파일명은 트리에 보임. 둘이 같을 필요 없음.

기능 1-b · 실습

첫 노트 1개 직접 만들기 — 3분

읽기 멈추고 — Obsidian 켜고 — 따라 해보세요. 막히면 옆 사람한테.

따라 하기 — 5단계

1

Ctrl+N 누르기

좌측 트리에 "Untitled.md" 한 개 생성됨

2

파일명 → "2026-05-28 첫 노트"

좌측 트리에서 클릭 후 F2 (또는 그냥 타이핑)

3

본문 첫 줄에 # 첫 노트 입력

샵 + 공백 → 큰 제목으로 자동 표시

4

아래 줄에 ## 오늘 배운 것

샵 두 개 = 중제목

5

Ctrl+S 저장 (또는 자동저장)

트리에서 파일 클릭 → 다시 돌아오기 확인

✅ 합격 — 다음 단계로

✓

트리에 .md 파일 1개 생김

좌측 사이드바에서 확인

✓

제목·중제목 다른 크기로 보임

마크다운이 실시간 렌더링됨

✓

파일을 닫고 다시 열기 가능

저장된 .md 가 다음 세션에도 남아있음

막힐 때 — Claude한테 "Obsidian에서 새 노트 못 만들겠어. 도와줘" 한 줄. 다음 슬라이드는 마크다운 6 기호.

기능 2 · 마크다운 5분 마스터

6개 기호만 외우면 끝

기호	무슨 뜻	예시
# ## ###	제목 (대·중·소)	# 주제 / ## 안건 / ### 세부
- (대시)	불릿 리스트	- 항목1 / - 항목2
- [ ]	체크박스 (할일)	- [ ] 미완 / - [x] 완료
굵게	강조 (Bold)	중요
> 인용	인용·메모박스	> "팀장 코멘트: …"
```코드```	코드 블록	백틱 3개로 감싸기

기억 안 나면 Ctrl+P 명령 팔레트에 "format" 검색. 마우스로도 다 됨.

기능 2-b · 실습

6 기호 한 번씩 — 5분

방금 만든 첫 노트에 6 기호를 하나씩 직접 써보세요. 미리보기 모드(Ctrl+E)로 결과 확인.

따라 치기 — 그대로 입력

# 마크다운 연습

## 오늘 한 일
- W5 슬라이드 검토
- Obsidian 첫 노트 만듦

## 할 일
- [ ] 마크다운 6기호 익히기
- [x] 첫 노트 만들기

## 메모
**중요**: 매일 5분 일일 노트

> "위키는 쌓일수록 비싸짐"

`Ctrl+N` 으로 새 노트.

확인 — 미리보기 모드 (Ctrl+E 토글)

✓

제목 (#, ##) — 글자 커짐

# 한 개 = 가장 큼. ## 두 개 = 중간 크기

✓

리스트 (-) — 불릿 점 자동

대시 + 공백 = 자동 동그라미

✓

체크박스 (- [ ]) — 클릭 가능

미완은 빈 박스, 완료(x)는 체크 표시

✓

굵게 — 두꺼운 글씨

* 두 개로 감싸기

✓

> 인용 — 회색 박스

꺾쇠 + 공백 = 회색 박스에 들어감

✓

` 백틱 — 코드 색깔

백틱 한 개 = 인라인 코드. 세 개 = 코드 블록

기능 3 · 핵심 ⭐

[[ ]] — Obsidian이 다른 도구와 가장 다른 점

노트 이름을 대괄호 2개로 감싸면 자동으로 다른 노트로 가는 링크가 됨.

쓰는 법

오늘 [[최정우]]와 미팅.
주제는 [[AI-Learning]] W5 자료.

관련: [[2026-05-21 주간회의]]
다음: [[2026-06-03 AI팀]]

파란색 = 클릭 가능한 노트 링크. 노트가 없으면 회색이지만 클릭하면 그 자리에서 생성됨.

왜 이게 강력한가

1

같은 사람·프로젝트가 자동으로 묶임

[[최정우]]를 10번 쓰면, 그 사람 노트에서 "어디서 언급됐는지" 자동 정리

2

회의록 따로 / 결정사항 따로

회의록에 [[결정-XX]] 링크 → 의사결정 노트에서 자동 백링크

3

Claude가 따라가며 읽음

"[[AI-Learning]]" 보고 그 노트 펼침 → 거기서 [[W5]] 펼침 → 맥락 완전 파악

기능 4 · 그래프뷰

Ctrl+G — 내 머리속이 별자리처럼 보임

[[ ]] 링크로 연결된 노트들이 노드와 선으로 시각화. 매주 노트 쌓으면 점점 빽빽해짐.

AI-Learning

W5 슬라이드

W7 데일리

최정우

회의록

큰 노드 = 많이 연결된 노트 (= 중요 주제). 고립 노드 = 연결 안 한 노트 (정리 필요).

활용 1 · 회의록

회의 시작 · 템플릿 한 장으로 시작

템플릿 — 그대로 복사해서 쓰기

# YYYY-MM-DD 회의 주제

**참석**: [[이름1]], [[이름2]]
**관련**: [[프로젝트]] · #회의록

## 안건
- 1.
- 2.

## 논의
- ...

## 결정 · Action
- [ ] (담당) [[이름]] (기한) 2026-MM-DD

왜 이 형식인가

1

제목 = 파일명

날짜+주제 = 다음에 찾기 쉬움

2

참석자 = [[ ]] 링크

그 사람 노트에서 "내가 참석한 회의" 자동 모임

3

Action = - [ ] 체크박스

전체 검색으로 "안 끝난 액션" 한 번에 모임

4

#회의록 태그

모든 회의록 한 줄로 필터링

정리 · 폴더 구조

시작은 4폴더면 충분

너무 정교한 구조는 함정. 일단 4개로 시작해서 부족하면 추가.

📁 00_Inbox

아무거나 일단 던지는 곳

정리할 시간 없을 때. 주말에 한 번 분류.

📁 10_회의록

날짜+주제 파일명

2026-05-27 AI팀.md 형식 통일.

📁 20_자료

읽은 자료 요약

기술·도구·외부 정보 한 줄 요약.

📁 30_프로젝트

진행 중 일

[[AI-Learning]], [[W5 자료]] 같은 허브 노트.

번호 prefix (00·10·20·30) = 트리에서 항상 같은 순서로 정렬. 1년 뒤 폴더가 늘어도 안 흩어짐.

다음 주 · Week 06 예고

위키가 차면 — Claude한테 들려주자

W5에서 사람 손으로 쓴 위키를, W6에선 LLM-WIKI로 Claude가 읽고·검색하고·갱신하게 합니다.

W5 (이번 주)

📚 사람 손 위키

Obsidian + 마크다운 5쪽
나만의 지식창고 첫 모습

→

W6 (다음 주)

🔌 LLM-WIKI 연결

Vault를 Claude에 MCP로 연결
"이번 주 회의 정리해줘" 한 줄

AI 팀 교육 · Week 06 예고 · Obsidian + Claude