This page serves as a comprehensive preview of all styled elements. Every theme preview site includes this page to showcase how the theme renders each element.
Heading 1
Heading 2
Heading 3
Heading 4
Heading 5
Heading 6
Text Formatting
Text text external link text internal link text bold text text italic text text bold and italic text text highlighted text text strikethrough text text.1
Style
Syntax
Example
Output
Bold
** ** or __ __
**Bold text**
Bold text
Italic
* * or _ _
*Italic text*
Italic text
Strikethrough
~~ ~~
~~Striked out text~~
Striked out text
Highlight
== ==
==Highlighted text==
Highlighted text
Bold and nested italic
** ** and _ _
**Bold text and _nested italic_ text**
Bold text and nested italic text
Bold and italic
*** *** or ___ ___
***Bold and italic text***
Bold and italic text
Blockquotes
Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
Doug Engelbart, 1961
Lists
Unordered List
First list item
Second list item
Third list item
Ordered List
First list item
Second list item
Third list item
Nested List
First list item
Ordered nested list item
Second list item
Unordered nested list item
Task List
This is a completed task.
This is an incomplete task.
Question
Cancelled
Deferred
Callouts
Note
Aliases: “note”
Abstract
Aliases: “abstract”, “summary”, “tldr”
Info
Aliases: “info”
Todo
Aliases: “todo”
Tip
Aliases: “tip”, “hint”, “important”
Success
Aliases: “success”, “check”, “done”
Question
Aliases: “question”, “help”, “faq”
Warning
Aliases: “warning”, “attention”, “caution”
Failure
Aliases: “failure”, “missing”, “fail”
Danger
Aliases: “danger”, “error”
Bug
Aliases: “bug”
Example
Aliases: “example”
Quote
Aliases: “quote”, “cite”
Code
Inline Code
Text inside backticks on a line will be formatted like code.
Code Blocks
cd ~/Desktop
function fancyAlert(arg) { if (arg) { $.facebox({ div: "#foo" }) }}
sequenceDiagram
Alice->>+John: Hello John, how are you?
Alice->>+John: John, can you hear me?
John-->>-Alice: Hi Alice, I can hear you!
John-->>-Alice: I feel great!
graph TD
Biology --> Chemistry
class Biology,Chemistry internal-link;
Embeds and Transclusions
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 already using Quartz to publish personal notes, websites, and digital gardens to the web.
Getting Started
Quartz requires at least Node v22 and npm v10.9.2 to function correctly. Ensure you have this installed on your machine before continuing.
Fully-customizable parsing, filtering, and page generation through plugins
For a comprehensive list of features, visit the features page. 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, 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 if you feel you found a bug or ask for help in our Discord Community. You can also browse the community page for third-party plugins and resources.
At its core, Quartz is designed to be easy to use enough for non-technical people to get going but also powerful enough that senior developers can tweak it to work how they’d like it to work.
If you like the default configuration of Quartz and just want to change the content, the only thing that you need to change is the contents of the content folder.
If you’d like to make basic configuration tweaks but don’t want to edit source code, one can tweak the plugins and components in quartz.config.yaml in a guided manner to their liking.
If you’d like to tweak the actual source code of the underlying plugins, components, or even build process, Quartz purposefully ships its full source code to the end user to allow customization at this level too.
Most software either confines you to either
Makes it easy to tweak content but not the presentation
Gives you too many knobs to tune the presentation without good opinionated defaults
Quartz should feel powerful but ultimately be an intuitive tool fully within your control. It should be a piece of agentic software. Ultimately, it should have the right affordances to nudge users towards good defaults but never dictate what the ‘correct’ way of using it is.