Introduction
next-md-blog is a small toolkit for running a blog from Markdown or MDX files on disk inside a Next.js application. It focuses on:
- Loading posts from a folder (with optional per-locale subfolders)
- Rendering markdown as React (server components) with sensible defaults and optional overrides
- SEO: Next.js
Metadata, JSON-LD (BlogPosting), RSS, and sitemap helpers - Scaffolding via
@next-md-blog/cliso you can add routes, config, and dependencies quickly
Packages
| Package | Role |
|---|---|
@next-md-blog/core | Runtime library: getBlogPost, MarkdownContent, metadata generators, feeds, types |
@next-md-blog/cli | npx @next-md-blog/cli initializer for a typical App Router layout |
Requirements
- Next.js
^16and React^19(peer dependencies of@next-md-blog/core) - Node.js 18+
Where to go next
- Getting started — install and first routes
- Configuration —
createConfigand site settings - API reference — every public export from the core package
This documentation site
The published documentation lives at www.next-md-blog.com .
To edit or preview locally after cloning the repository :
pnpm install
pnpm dev:docsOpen http://localhost:3001 . For production deployment, see Deployment.
Hosted examples: demo.next-md-blog.com (single-language) and demo.i18n.next-md-blog.com (multi-language / i18n).
Last updated on