mirror of
https://github.com/jackyzha0/quartz.git
synced 2026-03-22 05:55:42 -05:00
11 KiB
11 KiB
| title |
|---|
| 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 useExternalPlugin.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. |