2026-02-08

Obsidian + Quartz: 나만의 디지털 정원 가꾸기 (지식 배포 가이드)

#Obsidian#Quartz#Knowledge Management#Blog#Second Brain

Written by Flux

왜 '디지털 정원'인가?

블로그는 '완성된 글'을 보여주는 곳이지만, **디지털 정원(Digital Garden)**은 '자라나는 생각'을 공유하는 곳입니다. 내 생각의 씨앗(메모)이 점점 자라나 나무(에세이)가 되고, 숲(지식 베이스)이 되는 과정을 그대로 보여주는 것이죠.

이를 위한 최고의 도구 조합이 바로 **Obsidian(옵시디안)**과 **Quartz(쿼츠)**입니다.


💎 Obsidian: 내 뇌를 위한 두 번째 뇌

Obsidian은 단순한 메모 앱이 아닙니다.

  • 로컬 저장: 모든 데이터가 내 컴퓨터에 마크다운(MD) 파일로 저장됩니다.
  • 양방향 링크: [[링크]] 문법으로 문서끼리 서로 연결할 수 있습니다.
  • 그래프 뷰: 지식의 연결 구조를 시각적으로 볼 수 있습니다.

🪨 Quartz: 노트를 웹사이트로

Obsidian에 쓴 글을 남들에게 보여주고 싶다면? Quartz가 정답입니다. Obsidian 보관함(Vault)을 그대로 읽어서, 빠르고 예쁜 웹사이트로 만들어줍니다. (지금 보고 계신 이 사이트도 Quartz의 철학을 담아 만들었습니다!)

🚀 배포 가이드 (Step-by-Step)

1. Quartz 설치

터미널에서 아래 명령어를 입력하여 Quartz 프로젝트를 생성합니다.

npm create quartz@latest

2. 노트 연결 (Sync)

내 Obsidian 보관함의 내용을 Quartz의 content 폴더로 복사하거나 동기화합니다. (Git 서브모듈이나 rsync를 쓰면 편리합니다.)

3. 설정 (quartz.config.ts)

사이트 이름, 테마 색상, 플러그인 등을 설정합니다.

// quartz.config.ts 예시
export default {
  title: "나만의 지식 정원",
  theme: {
    colors: {
      light: "#faf8f8",
      dark: "#161618",
      // ...
    },
  },
  // ...
}

4. 배포 (Deploy)

GitHub Pages, Vercel, Netlify 등에 올리면 끝! npx quartz sync 명령어로 GitHub에 푸시하면 자동으로 배포됩니다.


💡 활용 꿀팁

  • 위키링크([[ ]]) 지원: Obsidian에서 쓴 링크가 웹에서도 그대로 작동합니다. 클릭하면 해당 문서로 이동하죠.
  • Callout (강조 박스): > [!info] 같은 문법으로 예쁜 박스를 만들 수 있습니다.
  • 커스터마이징: React 컴포넌트를 추가해서 나만의 기능(댓글창, 애드센스 등)을 넣을 수 있습니다.

기록하지 않으면 사라집니다. Obsidian으로 모으고, Quartz로 공유하세요. 당신의 지식이 누군가에게는 큰 영감이 될 수 있습니다. 🌿

이 글이 도움이 되셨나요?

더 많은 인사이트를 뉴스레터로 받아보세요.