Obsidian으로 자동 배포되는 VitePress 블로그 구축기
이 블로그는 로컬에서 사용하는 Obsidian이라는 마크다운 에디터에서 작성한 글이 자동으로 VitePress 기반 블로그에 배포되는 구조로 되어 있습니다. 개인 개발자로서 학습과 프로젝트에서 얻은 지식을 가볍게 기록하고, 손쉽게 공유하기 위해 만든 시스템입니다.
이 글에서는 왜 Obsidian을 선택했는지, VitePress와 어떻게 연동했는지, 그리고 자동 배포 환경을 어떻게 구성했는지를 단계별로 정리했습니다.
Obsidian이란?
Obsidian은 마크다운 기반의 지식 관리 도구로, 노트를 로컬 파일로 저장하며 노트 간 연결 관계를 그래프로 시각화할 수 있는 것이 특징입니다.
주요 특징
- 마크다운 지원: 텍스트 기반으로 메모를 작성할 수 있습니다.
- 링크 시스템: 노트 간 연결을 손쉽게 만들어 위키처럼 탐색할 수 있습니다.
- 그래프 보기: 노트 간 관계를 시각적으로 탐색할 수 있습니다.
- 플러그인 확장성: 필요에 따라 기능을 자유롭게 확장할 수 있습니다.
- 로컬 저장: 모든 데이터가 로컬에 저장되어 보안과 소유권이 확실합니다.
Obsidian을 선택한 이유
개발자에게 지속적인 기록은 선택이 아니라 습관입니다. 하지만 코딩과 기록을 동시에 하려면 꽤 번거롭습니다. 제가 원했던 기록 도구의 조건은 다음과 같았습니다.
- 여러 디바이스 간 동기화가 가능할 것
- 빠르고 간단하게 작성 및 수정이 가능할 것
- 폴더 단위로 손쉽게 분류할 수 있을 것
- 단순하지만 필요한 만큼 확장 가능한 구조일 것
기존에 사용하던 Notion이나 Tistory는 동기화 측면에서는 편리했지만, 속도와 확장성 면에서는 한계가 있었습니다. 반면 Obsidian은 모든 조건을 충족했습니다.
obsidian-git플러그인을 통해 GitHub 저장소를 이용한 자동 동기화가 가능합니다.- 로컬 환경에서 오프라인으로도 빠르게 기록할 수 있습니다.
- 폴더 단위로 파일을 관리하고, 사이드바에서 전체 구조를 한눈에 파악할 수 있습니다.
- 순정 상태는 가볍지만, 필요한 기능만 플러그인으로 추가할 수 있습니다.
결과적으로, 기록의 진입 장벽을 낮추어 더 자주, 더 쉽게 기록할 수 있었습니다.
“이걸 블로그에도 쓸 수 없을까?”
블로그에 글을 올릴 때마다 수정과 재배포가 번거로웠습니다. 반면 Obsidian에서는 다수의 파일을 손쉽게 넘나들며 수정할 수 있었습니다.
그래서 “Obsidian에서 작성한 글이 자동으로 블로그에 게시되면 어떨까?”라는 생각이 들었습니다.
가장 단순한 방법은 복사–붙여넣기였지만, 반복 작업이 많아 비효율적이었습니다. Obsidian의 유료 Publish 기능도 있었지만, 개인 개발자로서는 직접 구축해보는 편이 더 적합하다고 판단했습니다.
이때 사용 중이던 obsidian-git 플러그인을 통해 가능성을 발견했습니다. 결론적으로 다음과 같은 흐름을 구성했습니다.
Obsidian → obsidian-git → GitHub Repository → GitHub Actions → VitePress 빌드 & 배포 → GitHub Pages왜 VitePress인가?
Jekyll이나 Hugo 같은 정적 사이트 생성기들도 고려했지만, VitePress를 선택한 이유는 명확했습니다.
- 기본 테마가 Obsidian과 유사한 구조를 가지고 있습니다.
- 사이드바 | 콘텐츠 | ToC 레이아웃이 기본으로 제공되어 문서형 블로그에 최적화되어 있습니다.
- Vue 기반 생태계와 높은 확장성 덕분에 커스터마이징이 용이합니다.
- Vite, Rollup, VueUse 등 많은 공식 문서 사이트에서도 VitePress를 채택하고 있습니다.
구성 방법
전체 구현 과정은 별도 포스트에서 상세히 다룰 예정이지만, 주요 구성 요소는 아래와 같습니다.
Obsidian 플러그인
obsidian-git:
로컬 Vault를 GitHub 저장소에 자동 커밋 및 푸시하여 버전 관리와 배포 트리거 역할을 수행합니다.obsidian-link-converter:
Obsidian의 위키 링크([[link]])를 VitePress에서 사용하는 마크다운 링크로 자동 변환합니다.
VitePress 구성
- VitePress 공식 문서를 참고해 GitHub Pages 배포 환경을 구성합니다.
vitepress-sidebar:
배포 시 자동으로sidebar구성을 생성하여 문서 구조를 유지합니다.
마무리
지식과 기록은 개발자의 자산이지만, 기록 과정이 번거로우면 꾸준히 이어가기 어렵습니다.
Obsidian, VitePress, 그리고 GitHub Actions의 조합은 거창하지 않지만, 개인 개발자가 기술 블로그를 구축하기에 가장 단순하면서도 강력한 형태라고 생각합니다.
저는 이 환경을 통해 “기록해야 한다”는 부담감을 내려놓고, 기록이 자연스럽게 이어지는 흐름을 만들 수 있었습니다.
Obsidian은 분명, 개발자의 기록 여정을 가장 가까이에서 돕는 훌륭한 도구입니다.