Files
quartz-website/docs/plugins/index.md
T
2026-03-20 13:52:19 +01:00

12 KiB

title, image
title image
Plugins

Quartz's functionality is provided by a collection of first-party community plugins. Each plugin can be enabled, disabled, and configured via quartz.config.yaml. See configuration#Plugins for details on how to manage plugins.

[!info] Internal vs Community Plugins Quartz has two kinds of plugins:

  • Community plugins are standalone repositories under quartz-community. In TS overrides, they use ExternalPlugin.X() (imported from .quartz/plugins).
  • Internal plugins are built into Quartz core (Assets, Static, ComponentResources, NotFoundPage). In TS overrides, they use Plugin.X() (imported from ./quartz/plugins).

Plugin types

Quartz plugins fall into several categories:

  • Transformers process content during the build, e.g. parsing frontmatter, highlighting syntax, or resolving links.
  • Filters decide which content files to include or exclude from the output.
  • Page Types generate HTML pages — one per content file, folder, tag, canvas, or bases view.
  • Components render UI elements in the page layout (sidebars, headers, footers, etc.).

First-party plugins

Transformers

Plugin Repository Enabled Required Description
Frontmatter quartz-community/note-properties ✅ ✅ Parses frontmatter and displays note properties.
CreatedModifiedDate quartz-community/created-modified-date ✅ ❌ Determines creation and modification dates.
SyntaxHighlighting quartz-community/syntax-highlighting ✅ ❌ Syntax highlighting for code blocks.
ObsidianFlavoredMarkdown quartz-community/obsidian-flavored-markdown ✅ ❌ Obsidian-specific Markdown extensions.
GitHubFlavoredMarkdown quartz-community/github-flavored-markdown ✅ ❌ GitHub Flavored Markdown support.
TableOfContents quartz-community/table-of-contents ✅ ❌ Generates table of contents data from headings.¹
CrawlLinks quartz-community/crawl-links ✅ ⚠️ Parses and resolves links. Removing it is not recommended.
Description quartz-community/description ✅ ❌ Generates page descriptions for metadata.
Latex quartz-community/latex ✅ ❌ Renders LaTeX math expressions.
Citations quartz-community/citations ❌ ❌ Academic citation support via BibTeX.
HardLineBreaks quartz-community/hard-line-breaks ❌ ❌ Treats single newlines as hard line breaks.
OxHugoFlavoredMarkdown quartz-community/ox-hugo ❌ ❌ ox-hugo Markdown compatibility.
RoamFlavoredMarkdown quartz-community/roam ❌ ❌ Roam Research Markdown compatibility.

Filters

Plugin Repository Enabled Required Description
RemoveDrafts quartz-community/remove-draft ✅ ❌ Filters out pages marked as drafts.
ExplicitPublish quartz-community/explicit-publish ❌ ❌ Only publishes pages explicitly marked.

Page Types

Plugin Repository Enabled Required Description
ContentPage quartz-community/content-page ✅ ❌ Generates HTML pages for Markdown content.
FolderPage quartz-community/folder-page ✅ ❌ Generates folder listing pages.
TagPage quartz-community/tag-page ✅ ❌ Generates tag listing pages.
CanvasPage quartz-community/canvas-page ✅ ❌ Renders JSON Canvas files as interactive pages.
BasesPage quartz-community/bases-page ✅ ❌ Renders Obsidian Bases files as database views.

Emitters

Plugin Repository Enabled Required Description
AliasRedirects quartz-community/alias-redirects ✅ ❌ Generates redirect pages for aliases.
ContentIndex quartz-community/content-index ✅ ❌ Generates sitemap, RSS feed, and content index.
Favicon quartz-community/favicon ✅ ❌ Emits the site favicon.
CustomOgImages quartz-community/og-image ✅ ❌ Generates Open Graph social preview images.
CNAME quartz-community/cname ✅ ❌ Emits a CNAME file for custom domains.

Components

Plugin Repository Enabled Required Description
ArticleTitle quartz-community/article-title ✅ ❌ Renders the article title as an h1 heading.
ContentMeta quartz-community/content-meta ✅ ❌ Displays creation date and reading time.
TagList quartz-community/tag-list ❌ ❌ Renders tags as clickable links.
PageTitle quartz-community/page-title ✅ ❌ Renders the site title as a home link.
darkmode quartz-community/darkmode ✅ ❌ Toggle between light and dark themes.
reader mode quartz-community/reader-mode ✅ ❌ Distraction-free reading mode toggle.
explorer quartz-community/explorer ✅ ❌ File tree explorer sidebar.
graph view quartz-community/graph ✅ ❌ Interactive link graph visualization.
full-text search quartz-community/search ✅ ❌ Full-text search functionality.
backlinks quartz-community/backlinks ✅ ❌ Shows pages that link to the current page.
breadcrumbs quartz-community/breadcrumbs ✅ ❌ Breadcrumb navigation trail.
comments quartz-community/comments ❌ ❌ Comment system integration (Giscus, etc.).
Footer quartz-community/footer ✅ ❌ Page footer with configurable links.
recent notes quartz-community/recent-notes ❌ ❌ Displays a list of recently modified notes.
Spacer quartz-community/spacer ✅ ❌ Flexible spacer for layout groups.
TableOfContents¹ quartz-community/table-of-contents ✅ ❌ Renders the table of contents in the layout.
EncryptedPages quartz-community/encrypted-pages ✅ ❌ Password-protected encrypted pages.
StackedPages quartz-community/stacked-pages ✅ ❌ Andy Matuschak-style stacked sliding panes.

¹ TableOfContents is a dual-category plugin (transformer + component). It appears in both the Transformers and Components tables.