accept-md

CLI for accept-md: scaffold middleware and a markdown handler in your Next.js app so that requests with Accept: text/markdown get a markdown version of the page.

Installation

Use via npx (no global install):

``bash
npx accept-md init
`

Or install as a dev dependency:

`bash
pnpm add -D accept-md


or npm install -D accept-md


`

Commands

$3

Scans your Next.js project, detects App Router vs Pages Router and middleware location, and:

- Creates or updates middleware to rewrite Accept: text/markdown to the handler
- Adds the handler at app/api/accept-md/route.ts or route.js (App) or pages/api/accept-md/index.ts or index.js (Pages), depending on whether the project has TypeScript
- Creates accept-md.config.js
- Adds accept-md-runtime to dependencies

Options:

| Option | Description |
|--------|-------------|
| path | Project root (default: current directory) |
| --app-dir= | App directory (e.g. app or src/app) |
| --pages-dir= | Pages directory (e.g. pages or src/pages) |
| --middleware= | Middleware file (e.g. middleware.ts or src/middleware.ts) |

$3

Reports detected router, routes, and potential issues (missing handler, config, etc.).

$3

Patches .next/routes-manifest.json so it has a dataRoutes array. Use after next build if you hit “routesManifest.dataRoutes is not iterable” on Next.js 15+ with next start.

Programmatic API

`ts
import { runInit, runDoctor, runFixRoutes, detectProject } from 'accept-md';
`

- runInit(projectRoot, overrides?) – run init logic
- runDoctor(projectRoot) – run doctor, returns report
- runFixRoutes(projectRoot) – run fix-routes
- detectProject(projectRoot)` – detect app/pages/middleware paths

License

MIT · Repository