소개

Quartz Publish는 옵시디언 노트를 Quartz 블로그로 직접 발행할 수 있는 플러그인입니다.

기존에는 터미널에서 Git 명령어를 실행하거나 별도의 동기화 도구를 사용해야 했지만, 이 플러그인을 사용하면 옵시디언 내에서 버튼 클릭만으로 발행할 수 있습니다.

GitHub

주요 기능

  • 직접 발행 - 옵시디언에서 GitHub 저장소로 바로 발행
  • Frontmatter 설정 - publish, draft 등으로 발행 상태 제어
  • 필터링 - 폴더, 태그, glob 패턴으로 발행 대상 선택
  • Quartz 관리 - 사이트 설정, 버전 업그레이드, 원격 파일 관리
  • 초보자 지원 - GitHub 저장소 자동 생성 및 배포 가이드
  • 한국어 지원 - 영어/한국어 인터페이스

설치 방법

BRAT으로 설치 (추천)

  1. BRAT 플러그인 설치
  2. BRAT 설정에서 jeongsk/obsidian-quartz-publish 추가
  3. 플러그인 활성화

수동 설치

  1. 최신 릴리즈에서 파일 다운로드
  2. .obsidian/plugins/quartz-publish/ 폴더에 복사
  3. 옵시디언 설정에서 플러그인 활성화

필수 설정

플러그인 설정에서 다음 항목을 입력하세요:

  • GitHub 토큰 - repo 권한 필요
  • 저장소 URL - username/repo-name 형식
  • 브랜치 - 기본값 v4

사용법

Frontmatter 설정

---
publish: true      # 발행 대상
draft: false       # 초안 여부
---

발행하기

  1. 명령어 팔레트에서 Quartz Publish: 현재 노트를 Quartz에 발행 실행
  2. 자동으로 GitHub에 푸시 및 배포

발행 대시보드

발행 대시보드는 노트의 발행 상태를 확인하고 일괄 관리할 수 있는 기능입니다.

대시보드는 4개의 섹션으로 구성됩니다:

  • 🆕 신규 - 로컬에만 있는 신규 노트 (발행 필요)
  • ✏️ 수정됨 - 로컬에서 수정된 노트 (업데이트 필요)
  • 🗑️ 삭제 필요 - 로컬에서 삭제된 노트 (원격 삭제 필요)
  • ✅ 최신 - 로컬과 원격이 동일한 최신 상태

주요 작업:

  • 모두 동기화 - 모든 변경사항을 한 번에 동기화
  • 새로고침 - 발행 상태를 최신으로 갱신
  • 발행 - 선택한 노트만 발행 또는 삭제

관련 노트