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:
---
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