Quartz's default created modified date plugin.
  • TypeScript 100%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-09 23:02:01 +01:00
.changeset chore: version package 2026-11-09 17:20:35 +00:00
.github/workflows ci: run ci.yml on the changesets version PR and report it as a commit status 2026-11-09 03:47:25 +01:00
src fix: pass git a /-separated path (Windows gave content\notes\a.md); first tests, including git dates 2026-11-09 18:13:57 +01:00
test fix: pass git a /-separated path (Windows gave content\notes\a.md); first tests, including git dates 2026-11-09 18:13:57 +01:00
types chore: centralize type declarations and standardize tooling config 2026-03-16 18:55:26 +01:00
.eslintrc.json chore: centralize type declarations and standardize tooling config 2026-03-16 18:55:26 +01:00
.gitignore chore: migrate to npm publishing 2026-07-23 09:06:59 +02:00
.prettierignore chore: centralize type declarations and standardize tooling config 2026-03-16 18:55:26 +01:00
.prettierrc Initial commit 2026-02-13 21:38:46 +01:00
CHANGELOG.md chore: version package 2026-11-09 17:20:35 +00:00
LICENSE Initial commit 2026-02-13 21:38:46 +01:00
package-lock.json chore: version package 2026-11-09 17:20:35 +00:00
package.json chore: version package 2026-11-09 17:20:35 +00:00
README.md docs(readme): Quartz 5.1 — npm install and config, correct options and defaults 2026-11-09 22:56:18 +01:00
tsconfig.build.json fix: use separate tsconfig for DTS build to avoid vitest dependency 2026-03-22 13:12:01 +01:00
tsconfig.json Initial commit 2026-02-13 21:38:46 +01:00
tsup.config.ts fix: bundle JS deps while excluding native modules from bundling 2026-04-27 22:26:38 +02:00
vitest.config.ts fix: add passWithNoTests to vitest config 2026-03-09 03:21:30 +01:00

@quartz-community/created-modified-date

Extracts created, modified and published dates from frontmatter, git history, or filesystem metadata.

Frontmatter created, modified and published (and aliases such as date, lastmod and updated) are read. Git only provides the modified date; the filesystem provides created and modified dates. A source only fills dates that a higher-priority source has not set. Date-only values such as 2024-03-05 are read as local midnight.

Installation

npx quartz plugin add @quartz-community/created-modified-date

It is already included (and enabled) in the default quartz.config.yaml.

Usage

plugins:
  - source: "@quartz-community/created-modified-date"
    enabled: true
    options:
      defaultDateType: modified
      priority:
        - frontmatter
        - git
        - filesystem
    order: 10

For advanced use cases, you can override in TypeScript:

import * as ExternalPlugin from "./.quartz/plugins";

ExternalPlugin.CreatedModifiedDate({
  priority: ["frontmatter", "git", "filesystem"],
  defaultDateType: "modified",
});

Configuration

Option Type Default Description
priority ("frontmatter" | "git" | "filesystem")[] ["frontmatter", "git", "filesystem"] The order of sources to check for created and modified dates.
defaultDateType "created" | "modified" | "published" "modified" Which date to display (e.g. in content-meta, recent-notes and folder/tag listings).

If you rely on git for dates, keep defaultDateType: modified.

Documentation

See the Quartz documentation for more information.

License

MIT