Install

pnpm add @gentleduck/md

Optional: @gentleduck/md-sidecar for foreign remark / rehype plugins.

Quick start

// dmc.config.ts
import { defineConfig, s } from "@gentleduck/md";

export default defineConfig({
  output: { data: ".gentleduck", html: true },
  collections: {
    posts: {
      name: "Post",
      pattern: "content/posts/**/*.mdx",
      schema: (s) => s.object({
        title: s.string(),
        date: s.isodate(),
        slug: s.path(),
      }),
    },
  },
});

dmc build

Outputs .gentleduck/Post.json + typed index.d.ts. Import from any framework.

Watch mode

duck-md dev (alias duck-md watch) does an initial build, then rebuilds on file change via chokidar. It seeds a Map<absPath, sha256> of every .md / .mdx file under root after the first build and re-hashes on each change event; saves that don't alter content log [duck-md] no-op (<rel> unchanged) and skip the rebuild. The same check applies to the config file. add / unlink events always rebuild. This dedupe sits above the per-file blake3 cache in dmc-core.

Native features

Pretty code (syntect), KaTeX/MathML math, emoji, code imports, npm-command tabs, mermaid, bare URL autolinks, heading autolinks, asset copy.

JS plugins listed in config that have native equivalents (remark-gfm, rehype-pretty-code, rehype-katex, rehype-slug, etc) are stripped from the sidecar payload automatically.

Docs

Repo: github.com/gentleeduck/duck-mc

• Per-crate references, architecture, integration guides: dmc-docs/
• duck-ui website cross-link: github.com/gentleeduck/duck-ui
• Migration from velite: dmc-docs/guides/migrating-from-velite.md

Benchmarks

Five recorded phases; 9.5x velite at the kitchen-sink workload. Full numbers: duck-benchmarks/.

Contributing

PR checklist + style notes: CONTRIBUTING.md.

License

MIT