quartz/content/index.md

35 lines
1.8 KiB
Markdown
Raw Normal View History

---
2023-07-10 05:32:24 +03:00
title: Welcome to Quartz 4
---
2022-04-03 03:38:39 +03:00
2023-07-10 05:32:24 +03:00
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, wikis, and [digital gardens](https://jzhao.xyz/posts/networked-thought/) to the web.
2022-04-03 03:00:14 +03:00
2023-07-10 05:32:24 +03:00
## 🪴 Get Started
2023-07-23 03:27:41 +03:00
2023-07-10 05:32:24 +03:00
Quartz requires **at least [Node](https://nodejs.org/) v16** to function correctly. In your terminal of choice, enter the following commands line by line:
```shell
git clone https://github.com/jackyzha0/quartz.git
cd quartz
2023-07-10 05:32:24 +03:00
git checkout v4-alpha
npm i
npx quartz create
2023-07-10 05:32:24 +03:00
```
This will guide you through initializing your Quartz with content and previewing it locally.
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.
## 🔧 Features
- [[full-text search|Full-text search]], [[graph view]], [[backlinks]], [[Latex]], [[syntax highlighting]], [[popover previews]], and many more right out of the box
- Simple JSX [[creating components|layouts and page components]]
- [[SPA Routing|Ridiculously fast page loads]] and tiny bundle sizes
- Fully-customizable parsing, filtering, and page generation through [[making plugins|plugins]]
2023-07-23 03:27:41 +03:00
For a comprehensive list of features, visit the [features page](/features). You can read more the _why_ behind these features on the [[philosophy]] page.
2023-07-10 05:32:24 +03:00
### 🚧 Troubleshooting
2023-07-23 03:27:41 +03:00
2023-07-10 05:32:24 +03:00
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](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).