quartz/docs/getting-started/index.md

title

title
Getting Started

This guide walks you through setting up Quartz from scratch. If you already ran the index#🪴 Get Started on the home page, you can skip ahead to whichever step you're on.

Prerequisites

• Node.js v22 or later (run node -v to check)
• npm v10.9.2 or later (bundled with Node — run npm -v to check)
• Git (run git -v to check)

Setup Steps

Follow these in order:

1. installation — Clone Quartz, install dependencies, run the setup wizard (npx quartz create), install plugins, and preview your site locally
2. authoring-content — Write and organize your Markdown notes in the content/ folder
3. installation#Setting Up Your GitHub Repository — Create a repository and push your site with npx quartz sync
4. hosting — Host your site for free on GitHub Pages, Cloudflare, Netlify, or Vercel

Upgrading & Migrating

• upgrading — Keep your Quartz installation up to date
• migrating — Migrate from Quartz 4 or Quartz 3