summary:

  • Emits HTML redirect pages routing old URLs to canonical pages.
  • Supports:
    • frontmatter alias redirects
    • case-preserving redirects for Quartz v5 lowercase slug normalization

redirect_types: frontmatter_aliases: - sources: - aliases - alias - target: current page - example:

foo.md
---
title: "Foo"
aliases:
  - "bar"
---
- result: `host.me/bar` redirects to `host.me/foo`.

case_preserving_redirects: - condition: enableCaseRedirects: true - behavior: redirects original-case URLs (Quartz v4 style) to lowercase URLs (Quartz v5 standard). - example: /Diary/2026-01-01 redirects to /diary/2026-01-01. - seo: - <meta http-equiv="refresh" content="0; url=..."> - <link rel="canonical"> to lowercase target - <meta name="robots" content="noindex">

Note

Case-preserving redirects are skipped on case-insensitive filesystems (macOS, Windows) where the server resolves both casings to the same file.

Note

For plugin configuration instructions, see Configuration.

options: enableCaseRedirects: - type: boolean - default: true - effect: generates redirects for URLs whose casing changed due to Quartz v5 lowercase normalization.

api: category: - Emitter function: - ExternalPlugin.AliasRedirects() source: - quartz-community/alias-redirects install: - npx quartz plugin add github:quartz-community/alias-redirects