🏰 신라와 함께하는 ‘옵시디언 블로그’ 무작정 따라하기

안녕하세요, 필진 **신라(Silla)**입니다! 🏔️

최근 David V. Kimball이 소개한 ‘Vault CMS’ 풀 코스 영상이 큰 화제가 되었습니다. 옵시디언과 아스트로(Astro)를 결합하여 세상에서 가장 강력하고 빠른 블로그를 만드는 이 혁신적인 방법을, 입문자분들의 눈높이에 맞춰 더욱 보강하여 정리해 드립니다.

이 가이드 하나면 여러분도 오늘부터 ‘디지털 창작자’로 거듭날 수 있습니다!

🏗️ 0단계: 우리는 왜 이 조합을 선택하는가?

전통적인 워드프레스나 네이버 블로그 대신 이 방식을 선택하는 이유는 명확합니다.

완전한 소유권: 내 글은 깃허브와 내 컴퓨터에 마크다운(.md) 파일로 영원히 보관됩니다.
광속의 성능: Astro 엔진은 불필요한 코드를 모두 제거하여 전 세계에서 가장 빠른 웹사이트를 만들어줍니다.
글쓰기 몰입: 최고의 메모 도구인 옵시디언의 플러그인과 생태계를 그대로 활용합니다.

🛠️ 1단계: 기본 도구 세팅 (준비물)

가장 먼저 우리 컴퓨터에 ‘블로그 공장’을 차려야 합니다.

Node.js: 블로그 엔진을 돌리는 연료입니다. nodejs.org에서 LTS 버전을 설치하세요.
Git: 코드의 역사를 기록하는 장부입니다. git-scm.com에서 설치합니다.
Obsidian: 글을 쓰는 나만의 집필실입니다. obsidian.md에서 설치하세요.
VS Code: 가끔 코드를 들여다볼 때 쓰는 최고의 돋보기이자 칼입니다.

🍳 2단계: 나에게 맞는 ‘테마’와 ‘방식’ 고르기

Vault CMS 가이드에 따르면 사용자 숙련도에 따라 4가지 길을 선택할 수 있습니다.

방식	추천 대상	특징
Slate (초보)	터미널이 무서운 분	가장 단순하고 깔끔한 레이아웃
Fuwari (중급)	깃허브 사용이 익숙한 분	커스터마이징 폭이 넓고 미려한 디자인
Starlight (문서형)	기술 문서나 위키를 만들 분	체계적인 문서 구조화에 최적화
Modular (고급)	나만의 완벽한 시스템을 원하는 분	전용 설정 플러그인과 개발 서버 통합

☁️ 3단계: 세계 보관소와 연결 (GitHub & Vercel)

GitHub 저장소 생성: GitHub에서 새로운 Repository를 만듭니다.
Vercel 연결: Vercel.com에서 깃허브 계정으로 로그인한 뒤, 방금 만든 저장소를 Import 합니다.
자동 마법 시작: 이제 깃허브에 코드를 올리기만 하면 Vercel이 알아서 주소를 만들고 배포합니다.

🔄 4단계: 옵시디언 ‘마법의 동기화’ 설정 (핵심!)

Vault CMS의 핵심은 내 옵시디언 금고(Vault)가 그대로 블로그의 데이터베이스(CMS)가 된다는 점입니다.

폴더 설정: 옵시디언 안에 200 blog (또는 원하는 이름) 폴더를 만듭니다.
동기화 스크립트: 블로그 프로젝트 폴더에 있는 sync.sh를 실행하여 옵시디언의 글을 블로그의 src/content/posts 폴더로 복사합니다.
옵시디언 깃(Git) 플러그인 활용: 옵시디언 안에서 바로 깃허브로 글을 올리고 싶다면 ‘Obsidian Git’ 플러그인을 설치해 보세요. 터미널을 열지 않고도 글 작성이 끝남과 동시에 웹사이트에 반영할 수 있습니다!

🚑 제작 과정 트러블슈팅 (FAQ)

증상	원인	해결 방안
Vercel 빌드 에러	패키지 버전 불일치	`package.json`에 `"packageManager": "pnpm@11.x"`와 같은 버전을 명시해 보세요.
이미지가 안 나와요	상대 경로 문제	옵시디언의 이미지 링크 방식이 ‘Relative path to file’로 되어 있는지 확인하세요.
명령어 실행 불가	환경 변수 미설치	Node.js 설치 후 컴퓨터를 재부팅 하셨나요?