# Quartz
Quartz is a static site generator created by [[Jacky Zhao]], designed specifically for publishing [[Obsidian]] vaults and digital gardens to the web. Written in TypeScript, it transforms [[Markdown]] content into fast, fully-featured websites with navigation, full-text search, graph view, backlinks, and wiki-style linking; features that make it ideal for [[Personal Knowledge Management (PKM)]] publishing.
Unlike general-purpose static site generators like [[Jekyll]] or Hugo, Quartz is purpose-built for interconnected notes. It supports Obsidian-specific syntax (callouts, wikilinks, embeds) and can be deployed to [[GitHub Pages]], Netlify, or any static host. Quartz v4 (current) is a complete TypeScript rewrite offering improved performance and customization.
## Key Features
- **Obsidian compatibility**: Wikilinks, callouts, embeds, tags
- **Graph view**: Interactive visualization of note connections
- **Backlinks**: Automatic bidirectional linking
- **Full-text search**: Client-side search across all content
- **Fast builds**: Incremental compilation
- **Customizable**: Themes, plugins, components
## Obsidian Features Supported
- `[[Wikilinks]]` and `[[Link|Aliases]]`
- Callouts/admonitions
- Embeds and transclusions
- Tags and tag pages
- LaTeX math rendering
- Mermaid diagrams
## Quick Start
```bash
# Clone Quartz
git clone https://github.com/jackyzha0/quartz.git
cd quartz
# Install dependencies
npm i
# Add your content to /content folder
# Build and preview
npx quartz build --serve
```
## Quartz vs Obsidian Publish
| Aspect | Quartz | Obsidian Publish |
|--------|--------|------------------|
| Cost | Free | $8-16/month |
| Hosting | Self-hosted | Obsidian servers |
| Customization | Full control | Limited themes |
| Graph view | Yes | Yes |
| Search | Yes | Yes |
![[Quartz (App) - overview.png]]
## References
- Official website: https://quartz.jzhao.xyz
- Configuration: https://quartz.jzhao.xyz/configuration
- Obsidian compatibility: https://quartz.jzhao.xyz/features/Obsidian-compatibility
- Source code: https://github.com/jackyzha0/quartz
- Discord server: https://discord.gg/cRFFHYye7t
## Related
- [[Obsidian]]
- [[Personal Knowledge Management (PKM)]]
- [[GitHub Pages]]
- [[Jekyll]]
- [[Markdown]]
- [[Digital Garden]]