Documentation

next-md-blog

Multi-language markdown blog

An i18n demo: per-locale posts, locale switcher, and the same polished reading experience.

Locale-aware posts

Organize content under posts/[locale]/ with matching URL segments.

Markdown + frontmatter

Author in .md with YAML metadata; content stays in git.

App Router routes

Dynamic /[locale]/blog/[slug] and localized listing pages.

SEO-ready

Metadata helpers, JSON-LD, sitemap, and Open Graph images.

Type-safe API

Typed post loaders with locale passed through @next-md-blog/core.

Typography

Prose styling via Tailwind Typography for readable long-form.

Light & dark

Theme toggle with system preference via next-themes.

Quick start

Enable i18n when you scaffold

  1. Install: npm install @next-md-blog/core
  2. Scaffold: npx next-md-blog-init --i18n-enabled
  3. Add posts under posts/[locale]/
  4. Routes resolve at /[locale]/blog/[slug]