Quartz로 Obsidian 노트 배포하기

Key Claims

• Quartz는 Obsidian Markdown 노트를 정적 웹사이트로 변환하는 오픈소스 SSG다. jackyzha0/quartz 저장소 기반.¹
• 초기화: git clone https://github.com/jackyzha0/quartz.git && cd quartz && npm i && npx quartz create. 링크 해결 방식은 "Treat links as shortest path" 선택.¹
• 원본 origin을 자신의 GitHub 저장소로 변경하고, Quartz 업스트림 업데이트를 받기 위해 upstream remote를 추가한다.¹
• GitHub Pages 배포는 .github/workflows/deploy.yml Actions 파일로 자동화한다.¹
• Quartz 4.0의 기본 브랜치는 v4지만 main으로 변경 가능하다.¹
• Google Analytics 설정이 이미 있다면 Google Search Console 소유권 확인을 가장 쉽게 처리할 수 있다. quartz.config.ts에서 analytics.provider: "google", tagId: "G-XXXX" 설정.¹

Examples / Code

Remote 설정:

# origin을 자신의 레포로 변경
git remote set-url origin https://github.com/username/username.github.io.git
 
# Quartz 공식 저장소를 upstream으로 추가
git remote add upstream https://github.com/jackyzha0/quartz.git

GitHub Actions 배포 파일 위치: .github/workflows/deploy.yml

Google Analytics + Search Console 설정 (quartz.config.ts):

analytics: {
  provider: "google",
  tagId: "G-YOUR_TAG_ID",
}

Connections

• blog-seo — Quartz 배포 후 Google Search Console 등록과 SEO 최적화 설정 단계
• static-site-generators — Quartz는 Obsidian에 특화된 SSG이며, Jekyll/Hugo 등 범용 SSG와 비교 가능

Footnotes