An Obsidian plugin for publishing notes directly to your Quartz blog.
- Publish Obsidian notes directly to Quartz repository
- Configure publish paths using frontmatter
- Choose between draft or publish status
- Automatic deployment via GitHub repository integration
- Folder-based publish target filtering
- Tag-based publish target filtering
- Flexible filter settings using Glob patterns
- Quartz configuration management (site info, analytics, locale, etc.)
- Quartz version upgrade support
- Remote file management (direct management of files in Quartz repository)
- Network offline detection
- Warning for large file publishing
- Multi-language support (English, Korean)
- Download the latest version from Releases.
- Copy
main.js,manifest.json, andstyles.cssto the.obsidian/plugins/quartz-publish/folder in your Obsidian vault. - Restart Obsidian and enable "Quartz Publish" in Settings > Community Plugins.
- Install the BRAT plugin.
- Select "Add Beta plugin" in BRAT settings.
- Enter
jeongsk/obsidian-quartz-publishand add it.
Configure the following items in the plugin settings:
- GitHub Token: GitHub Personal Access Token (repo permission required)
- Repository: GitHub repository where Quartz is installed (e.g.,
username/quartz) - Branch: Branch to publish to (default:
main) - Content Path: Quartz content path (default:
content)
- Open the note you want to publish.
- Search for "Quartz Publish" in the command palette (Cmd/Ctrl + P).
- Select publishing options and publish.
You can configure publishing options in your note's frontmatter:
---
title: Note Title
draft: false
publish: true
path: custom-url-path
---- Node.js >= 22.0.0
- npm
git clone https://github.com/jeongsk/obsidian-quartz-publish.git
cd obsidian-quartz-publish
npm installnpm run dev # Development mode (watch)
npm run build # Production build
npm run test # Run tests
npm run test:watch # Test watch mode
npm run test:coverage # Coverage report
npm run lint # Lint check
npm run lint:fix # Auto-fix linting
npm run version # Version upgrade- Language: TypeScript 5.9+
- Styling: TailwindCSS v4
- Bundler: esbuild
- Testing: Vitest
- Linter: ESLint + eslint-plugin-obsidianmd
MIT © Jeongsk