42 lines
2.5 KiB
Markdown
42 lines
2.5 KiB
Markdown
---
|
|
title: Welcome to Quartz 5
|
|
---
|
|
|
|
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|already using Quartz]] to publish personal notes, websites, and [digital gardens](https://jzhao.xyz/posts/networked-thought) to the web.
|
|
|
|
## Getting Started
|
|
|
|
Quartz requires **at least [Node](https://nodejs.org/) v22** and `npm` v10.9.2 to function correctly. Ensure you have this installed on your machine before continuing.
|
|
|
|
### New to Quartz?
|
|
|
|
1. **[[getting-started/installation|Set up your repository]]** — Fork and clone the Quartz template
|
|
2. **[[getting-started/installation|Initialize]]** — Run `npx quartz create` to choose a template and configure your site
|
|
3. **[[build|Build]]** — Preview your site locally with `npx quartz build --serve`
|
|
4. **[[hosting|Deploy]]** — Host your site for free on GitHub Pages, Cloudflare, or Netlify
|
|
|
|
### Returning User?
|
|
|
|
If you've already set up Quartz and are cloning your repository on a new machine:
|
|
|
|
```shell
|
|
npx quartz plugin install
|
|
npx quartz build --serve
|
|
```
|
|
|
|
## 🔧 Features
|
|
|
|
- [[Obsidian compatibility]], [[full-text search]], [[graph view]], [[wikilinks|wikilinks, transclusions]], [[backlinks]], [[features/Latex|Latex]], [[syntax highlighting]], [[popover previews]], [[Docker Support]], [[i18n|internationalization]], [[comments]] and [many more](./features/) right out of the box
|
|
- Hot-reload on configuration edits and incremental rebuilds for content edits
|
|
- Simple JSX layouts and [[creating components|page components]]
|
|
- [[SPA Routing|Ridiculously fast page loads]] and tiny bundle sizes
|
|
- Fully-customizable parsing, filtering, and page generation through [[making plugins|plugins]]
|
|
|
|
For a comprehensive list of features, visit the [features page](./features/). You can read more about the _why_ behind these features on the [[philosophy]] page and a technical overview on the [[architecture]] page.
|
|
|
|
### 🚧 Troubleshooting + Updating
|
|
|
|
Having trouble with Quartz? Try searching for your issue using the search feature or check the [[troubleshooting]] page. If you haven't already, [[upgrading|upgrade]] to the newest version of Quartz to see if this fixes your issue.
|
|
|
|
If you're still having trouble, feel free to [submit an issue](https://github.com/jackyzha0/quartz/issues) if you feel you found a bug or ask for help in our [Discord Community](https://discord.gg/cRFFHYye7t). You can also browse the [[community]] page for third-party plugins and resources.
|