roadmap/content/index.md

2.1 KiB

title
Welcome to Quartz 4

Quartz is a fast, batteries-included static-site generator that transforms Markdown content into fully functional websites. Thousands of students, developers, and teachers are showcase to publish personal notes, wikis, and digital gardens to the web.

🪴 Get Started

Quartz requires at least Node v18.14 to function correctly. Ensure you have this installed on your machine before continuing.

Then, in your terminal of choice, enter the following commands line by line:

git clone https://github.com/jackyzha0/quartz.git
cd quartz
git checkout v4-alpha
npm i
npx quartz create

This will guide you through initializing your Quartz with content.

When you're ready, you can edit quartz.config.ts to customize and configure Quartz more. Read the configuration page for more information on what each field in the configuration does.

Then, when you're ready, see how to build and hosting Quartz.

[!info] Coming from Quartz 3? See the migrating from Quartz 3 for the differences between Quartz 3 and Quartz 4 and how to migrate.

🔧 Features

For a comprehensive list of features, visit the features page. You can read more the why behind these features on the philosophy page.

🚧 Troubleshooting

Having trouble with Quartz? Try searching for your issue using the search feature. If you're still having trouble, feel free to submit an issue if you feel you found a bug or ask for help in our Discord Community.