quartz-blog-frontmatter-normalizer

To normalize Quartz markdown filenames and frontmatter, convert filename stems to ASCII kebab-case, add missing descriptions, default draft to true, and translate Chinese tags to English kebab-case. This process preserves the article body byte-for-byte while ensuring consistent metadata for deployment.

Converting Chinese tags to English kebab-case in markdown frontmatter involves translating the tags and normalizing their format. The process requires confirmation for ambiguous translations to ensure accuracy while preserving all existing article content completely unchanged.

Frontmatter normalization does not overwrite existing draft values or aliases in Quartz posts. It only defaults missing draft values to true and appends the original title to aliases during a filename rename, carefully avoiding any duplication or overwriting of existing entries.

The best way to standardize markdown filenames to ASCII kebab-case without altering content is to rename the file stem while preserving the .md extension. This approach edits only the YAML frontmatter and filename, leaving the article body byte-for-byte intact.

Quartz blog deployments can encounter issues when frontmatter lacks draft values or descriptions because the static site generator expects consistent metadata. Normalizing these fields by adding a short Chinese description and defaulting draft to true ensures reliable publishing.