diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..0783d44 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,45 @@ +--- +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|already using Quartz]] to publish personal notes, websites, and [digital gardens](https://jzhao.xyz/posts/networked-thought) to the web. + +## 🪴 Get Started + +Quartz requires **at least [Node](https://nodejs.org/) v18.14** and `npm` v9.3.1 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: + +```shell +git clone https://github.com/jackyzha0/quartz.git +cd quartz +npm i +npx quartz create +``` + +This will guide you through initializing your Quartz with content. Once you've done so, see how to: + +1. [[authoring content|Writing content]] in Quartz +2. [[configuration|Configure]] Quartz's behaviour +3. Change Quartz's [[layout]] +4. [[build|Build and preview]] Quartz +5. [[hosting|Host]] Quartz online + +If you prefer video format you can also try following Nicole van der Hoeven's +[video guide on how set up Quartz!](https://www.youtube.com/watch?v=6s6DT1yN4dw&t=227s) + +## 🔧 Features + +- [[Obsidian compatibility]], [[full-text search]], [[graph view]], note transclusion, [[wikilinks]], [[backlinks]], [[Latex]], [[syntax highlighting]], [[popover previews]], [[Docker Support]], and [many more](./features) right out of the box +- Hot-reload for both configuration and content +- 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. 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).