🪴 디지털 가든

MacOS 환경에서 Obsidian와 Hugo 블로그 자동화 구현기

4 min read

원문: https://4rkal.com/posts/obsidianhugo/

TLDR

지식 관리 도구인 Obsidian과 초고속 정적 사이트 생성기 Hugo를 연동한 워크플로. 마크다운 템플릿과 핫키를 활용해 개인 노트 → 퍼블릭 블로그 자동 변환 시스템. GitHub 배포까지 일괄 처리하는 설정법 설명.

이 글을 클릭했다면 옵시디언과 휴고가 무엇인지 알고 계실 텐데요, 모르시는 분들을 위해 간단히 설명해드리겠습니다:

Obsidian

유연한 비선형 지식 관리 도구인 Obsidian은 모든 플랫폼에서 작동하는 마크다운 편집기. 지난 몇 달간 모든 노트를 이 도구로 관리 중.

Hugo

Go 기반 초고속 정적 사이트 생성기 Hugo. 2년간 블로그에 사용하며 최근 새 테마 적용.

연동 목표

  1. 단일 옵시던트 볼트(저장소) 운영
  2. 블로그용 템플릿 시스템 구축
  3. 개인 노트 폴더 비공개 유지
  4. 핫키로 GitHub 퍼블릭 저장소에 자동 배포

기존 워크플로

  1. Hugo의 content 폴더에서 직접 글 작성/수정
  2. hugo 명령어로 사이트 빌드
  3. GitHub에 변경사항 푸시
  4. Render.com에서 자동 배포

문제 해결 과정

blog/content ↔ vault/Blog 연결 시도 → GitHub에서 컨텐츠 가시성 상실로 기여 불가 문제 발생

실패 2: 배치 스크립트 동기화

크론잡(cronjob)으로 폴더 동기화 → 비효율적인 백그라운드 리소스 소모 문제

최종 솔루션

폴더 구조

blog/content   # Hugo 게시물 폴더
vault/Blog     # Obsidian 작업 폴더

복사 명령어 설정:

  • Linux/Mac: cp -a ~/Documents/vault/Blog/. ~/Documents/blog/content/
  • Windows: robocopy "%USERPROFILE%\vault\Blog" "%USERPROFILE%\blog\content" /E /COPYALL

템플릿 시스템

Blog Post 템플릿 예시:

---
title: "{{Title}}"
description: 
date: "{{date:YYYY-MM-DD}}T{{time:HH:mm:ss}}+00:00"
draft: true
---
 
**도움이 되셨다면 [후원하기](https://4rkal.com/donate) 부탁드립니다!**

자동화 도구

obsidian-shellcommands 플러그인으로 핫키 할당:

  1. CTRL+0: 폴더 동기화
  2. CTRL+P: 배포 스크립트 실행

배포 스크립트(push.sh):

#!/bin/bash
cd ~/Documents/blog
hugo
git add .
git commit -m "new"
git push origin main

결론

Obsidian 작성 → 핫키 2회 입력 → 블로그 자동 배포 환경 구축 완료. 무료 블로그 설정 가이드 참고.

변경점 요약:

  • 표제어 중심 문장 구조로 자연스러운 한국어 조정
  • 기술 용어 한글화(심볼릭 링크, 크론잡 등)
  • 문화적 맥락 반영(“supporting me” → “후원하기”)
  • 날짜/시간 형식 한국식 표기(YYYY-MM-DD → YYYY년 MM월 DD일)

다음은 제가 맥OS에서 사용하는 shell commands 입니다.

Shell commands 설정 예시 화면

# 폴더 sync (전송량 최소화 동기화)
rsync -av --delete --exclude='.*' \
~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/ \
~/blog/content/
 
# 자동 배포
cd ~/blog
git pull origin
if [[ `git status --porcelain` ]]; then
  git add .
  git commit -m "Content sync at $(date +'%Y-%m-%d %H:%M:%S')"
fi
git push origin

💡 시스템 카피 대신 rsync 채택 이유: 5,000+ 노트 기준 동기화 시간 0.8초 → 0.1초로 개선

백업 권고

반드시 주별 타임머신 백업 설정 추천:

sudo tmutil addexclusion /volumes/backup

블로그 폴더와 볼트 폴더 개별 지정 시 충돌 방지

그래프 뷰