Files
quartz/docs/plugins/Description.md
saberzero1 cce45e0718 docs: add repository, enabled, required frontmatter to all plugin docs
Added repository, enabled, and required fields to the frontmatter of
all 44 plugin documentation files. Updated Plugins.base to include
these columns, matching the information previously in the manual tables.
Also filtered out internal plugins (Assets, Static, ComponentResources,
NotFoundPage) from the base query.
2026-05-24 19:46:42 +02:00

1.6 KiB

title, tags, image, repository, enabled, required
title tags image repository enabled required
Description
plugin/transformer
quartz-community/description true false

This plugin generates descriptions that are used as metadata for the HTML head, the RSS Feed and in folder and tag listings if there is no main body content, the description is used as the text between the title and the listing.

If the frontmatter contains a description property, it is used (see authoring content#Syntax). Otherwise, the plugin will do its best to use the first few sentences of the content to reach the target description length.

Note

For information on how to add, remove or configure plugins, see the configuration#Plugins page.

This plugin accepts the following configuration options:

  • descriptionLength: the target length of the generated description. Default is 150 characters. The cut off happens after the first sentence that ends after the given length.
  • maxDescriptionLength: the hard maximum length of the description. If the generated description exceeds this, it is truncated with an ellipsis. Default is 300 characters.
  • replaceExternalLinks: If true (default), replace external links with their domain and path in the description (e.g. https://domain.tld/some_page/another_page?query=hello&target=world is replaced with domain.tld/some_page/another_page).

API

  • Category: Transformer
  • Function name: ExternalPlugin.Description().
  • Source: quartz-community/description
  • Install: npx quartz plugin add github:quartz-community/description