본문 바로가기
스터디 열기

폴더 만들고 Obsidian으로 열기

1. 폴더 만들고 Obsidian으로 열기

이 장은 설명을 뒤로 미루고 손부터 움직입니다. 30분 뒤에는 자료 두 건이 들어간 위키와 그 위키에 던진 질문 몇 개가 남습니다. 해 보고 나서 "나한테는 메모리와 지난 대화 검색으로 충분하다"는 판단이 서도 괜찮습니다. 그 판단을 직접 해 보는 것이 이 장의 목적이기도 합니다. 왜 이렇게 만드는지는 4장부터 다시 설명합니다.

전체 흐름은 이렇습니다.

1.1 빈 폴더 하나 만들기

먼저 컴퓨터에 빈 폴더를 만듭니다. 이름은 work-wiki로 하겠습니다. 위치를 고를 때 세 가지만 신경 쓰면 됩니다.

경로에 한글과 공백 피하기: C:\Users\내이름\문서\내 위키 같은 경로도 대개 동작하지만, 나중에 Git 같은 도구를 붙일 때 종종 말썽이 됩니다. C:\Users\hojun\work-wiki처럼 영문과 하이픈으로 된 경로를 권합니다. macOS라면 ~/work-wiki면 충분합니다.

클라우드 동기화 폴더는 신중하게: OneDrive나 Google Drive, iCloud 폴더 안에 두면 여러 기기에서 같은 위키를 볼 수 있어 편합니다. 다만 AI가 한 번에 파일 수십 개를 고치는 동안 동기화가 끼어들면 충돌 사본이 생기기도 합니다. 처음에는 동기화되지 않는 위치에 두고, 익숙해진 뒤 10장에서 다루는 Git으로 옮기는 편이 안전합니다.

위키 전용 폴더로: 바탕화면이나 문서 폴더 전체를 쓰지 말고 위키만을 위한 폴더를 따로 둡니다. Anthropic도 Claude에게 넓은 범위를 열어 주기보다 작업 전용 폴더를 만들라고 권합니다. 위키 폴더 안에 위키의 것만 있어야 AI가 엉뚱한 파일을 건드리지 않고, 인제스트할 때도 헷갈리지 않습니다.

1.2 Obsidian 설치하기

obsidian.md에 접속해 자기 운영체제에 맞는 설치 파일을 내려받아 실행합니다. 내려받기 화면은 접속한 컴퓨터의 운영체제를 알아보고 맞는 단추를 보여 줍니다. 계정을 만들지 않아도 됩니다.

Obsidian 내려받기 화면은 Windows에서 접속하면 Download for Windows 단추를 보여 줍니다.

요금 걱정도 없습니다. Obsidian은 개인 사용과 업무 사용 모두 무료입니다. 예전에는 회사에서 쓰려면 상업용 라이선스가 필요했지만, 2025년 2월 20일부터 상업용 라이선스는 선택 사항이 됐습니다. 돈을 내는 것은 여러 기기 동기화(Sync)나 웹 게시(Publish) 같은 추가 서비스뿐이고, 이 책의 실습에는 둘 다 필요 없습니다.

설치 과정에서 물어보는 것이 거의 없습니다. 다음을 몇 번 누르면 끝납니다.

1.3 폴더를 보관함으로 열기

Obsidian은 폴더 하나를 통째로 열어서 다룹니다. 이 열린 폴더를 보관함(Vault)이라고 부릅니다. 별도의 저장소로 옮기거나 파일 형식을 바꾸지 않고, 그 폴더를 그냥 보여 줄 뿐입니다.

처음 실행하면 보관함을 고르는 화면이 나옵니다. 여기서 폴더를 보관함으로 여는 메뉴(영문 화면에서는 Open folder as vault)의 Open을 누르고 방금 만든 work-wiki 폴더를 지정합니다.

새 보관함을 만드는 메뉴(Create new vault)를 골라도 결과는 같습니다. 다만 그 경우 Obsidian이 폴더를 새로 만들어 주므로, 이미 폴더를 만들어 뒀다면 열기 쪽이 헷갈리지 않습니다. 지금 버전(1.14.5) 화면 맨 위에 있는 Quick start 단추는 이 책에서 쓰지 않습니다. 화면 맨 아래 언어 칸에서 화면 언어를 바꿀 수 있습니다.

Obsidian 1.14.5를 처음 실행하면 Quick start 단추 아래에 Create new vault, Open folder as vault, Open vault from Obsidian Sync 세 가지 선택지가 나옵니다.

폴더가 비어 있으니 화면도 비어 있는 것이 정상입니다. 왼쪽에 파일 목록, 가운데에 문서를 여는 자리가 있는 구조만 확인해 두면 됩니다.

빈 work-wiki 폴더를 연 Obsidian 화면은 왼쪽 파일 목록이 비어 있고, 가운데에 New note, New base, New canvas 단추만 보입니다.

보관함을 열 때 나오는 확인 창: 처음 보는 보관함을 열면 Obsidian이 플러그인을 믿고 켤지 묻는 창을 띄울 수 있습니다. Obsidian은 기본으로 제한 모드(Restricted Mode)로 돌아가서, 남이 만든 커뮤니티 플러그인의 코드가 저절로 실행되지 않게 막습니다. 남이 준 보관함에 플러그인이 숨어 있을 수 있어 붙은 안전장치입니다. 확인 창의 문구는 버전마다 조금씩 다르고 1.13 버전에서도 바뀌었습니다. 지금 연 것은 내가 만든 빈 폴더이고 이 장의 실습에는 커뮤니티 플러그인이 하나도 필요 없으니, 제한 모드를 그대로 두고 진행하면 됩니다. 커뮤니티 플러그인은 필요한 때(7장의 Marp 슬라이드, 10장의 Git)가 오면 그때 켭니다.

1.4 마크다운을 아주 조금만

앞으로 다룰 문서는 전부 마크다운입니다. 직접 쓸 일은 거의 없고 AI가 만들어 주지만, 읽을 수는 있어야 하니 필요한 만큼만 봅니다.

# 제목
## 소제목

일반 문장입니다. **굵게**와 `코드 표시`를 이렇게 씁니다.

- 목록 항목
- 또 다른 항목

| 열1 | 열2 |
|-----|-----|
| 값 | 값 |

[[다른 문서 이름]]

#의 개수가 제목의 단계입니다. -로 시작하면 목록이고, |로 칸을 나누면 표가 됩니다. 마지막 줄의 대괄호 두 개는 마크다운 표준 문법은 아니지만 위키 문서끼리 서로를 가리킬 때 널리 쓰이는 표기이고, Obsidian이 이 표기를 그대로 알아듣습니다.

파일 확장자는 .md이고 메모장으로 열어도 그냥 읽힙니다. 특별한 프로그램 없이도 내용이 보인다는 점이 이 형식을 고른 이유입니다. Obsidian을 그만 쓰거나 Claude 대신 다른 AI를 쓰게 되어도 파일은 그대로 남습니다.

1.5 직접 한 장 만들어 보기

감을 잡기 위해 문서 한 장만 손으로 만들어 봅니다. Obsidian에서 새 노트를 만들고(왼쪽 위 새 노트 아이콘, 또는 Windows Ctrl+N, macOS Cmd+N) 이름을 테스트로 준 뒤 아래를 붙여 넣습니다.

# 테스트

이건 [[경쟁사-A]] 문서를 가리키는 링크입니다.

[[경쟁사-A]] 부분이 다른 색으로 보이고, 눌러 보면 그런 문서가 없으니 새로 만들어집니다. 없는 문서를 가리키는 링크를 미리 걸어 둘 수 있다는 뜻입니다. 이 성질이 나중에 요긴합니다. AI가 아직 안 만든 문서를 미리 링크로 걸어 두면 그 자체가 할 일 목록이 됩니다.

확인했으면 테스트 문서와 방금 생긴 경쟁사-A 문서는 지웁니다. 파일 목록에서 오른쪽 클릭 후 삭제하면 됩니다.

다음 절에서 이 폴더를 Claude에 연결합니다.

마지막 수정