Turns a Notion workspace into a customizable public website for blogs, portfolios, docs, and landing pages, built on Next.js and the Notion API.
leerob/next-mdx-blog
A Next.js blog template that renders MDX posts with Tailwind CSS and TypeScript, ready to deploy on Vercel.
- Stars
- 7,575
- Forks
- 1,446
- Open issues
- 0
- Last commit
- last month
What is it?
next-mdx-blog is a starter template for a personal blog. It is built on Next.js and TypeScript, styled with Tailwind CSS, and writes posts in MDX so Markdown content can include React components.
The template is set up for Vercel deployment and includes Vercel Analytics. An optional Postgres database can store redirect rules, which are defined in a redirects table with source, destination, and permanent fields.
To run it locally, clone the repository, install dependencies with pnpm, and start the dev server. The project requires Node.js v18.17 or later.
Key features
- 01Writes posts in MDX, mixing Markdown with React components.
- 02Uses Next.js and TypeScript as the application foundation.
- 03Styled with Tailwind CSS.
- 04Includes Vercel Analytics and a one-click Vercel deploy button.
- 05Optionally stores redirect rules in Postgres.
Use cases
- Launching a personal developer blog with Markdown-based posts.
- Starting a Next.js content site that needs MDX and Tailwind CSS.
- Deploying a blog to Vercel with analytics out of the box.
Quick start
- 1
Clone the repository
git clone https://github.com/leerob/next-mdx-blog.git - 2
Enter the project folder
cd next-mdx-blog - 3
Install dependencies with pnpm
pnpm install - 4
Start the development server
pnpm dev
Things to know
- No license is specified, so reuse rights are unclear.
Topics
FAQ
- What is next-mdx-blog?
- A Next.js blog template that renders MDX posts with Tailwind CSS and TypeScript, ready to deploy on Vercel. next-mdx-blog is a starter template for a personal blog. It is built on Next.js and TypeScript, styled with Tailwind CSS, and writes posts in MDX so Markdown content can include React components.
- Is next-mdx-blog free to use? What license does it have?
- next-mdx-blog has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
- Is next-mdx-blog still maintained?
- Updated within 6 months. The last commit to next-mdx-blog was on Sep 16, 2026.
- What can I use next-mdx-blog for?
- Launching a personal developer blog with Markdown-based posts. Starting a Next.js content site that needs MDX and Tailwind CSS. Deploying a blog to Vercel with analytics out of the box.
- How do I install next-mdx-blog?
- Clone the repository: git clone https://github.com/leerob/next-mdx-blog.git Enter the project folder: cd next-mdx-blog Install dependencies with pnpm: pnpm install Start the development server: pnpm dev
- Where can I get next-mdx-blog?
- The source code and installation instructions are on GitHub: https://github.com/leerob/next-mdx-blog
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A framework for building documentation websites with React.js, supporting Next.js, Astro, and Vite-based React frameworks.
A React and Tailwind CSS component library of animated UI components and effects that you copy into your Next.js or shadcn/ui apps.
A production-ready Next.js 15 starter template with TypeScript, Tailwind CSS v4, testing, linting and optional AWS deployment infrastructure.
Open-source Next.js SaaS starter with Clerk auth, multi-tenancy, RBAC, i18n, Drizzle ORM and Tailwind CSS.
A React and Next.js cursor animation library offering reusable cursor-follow effects, built on Tailwind CSS and motion.