Skip to content
Avatar of eshan-singh78eshan-singh78/MDXpress-Blog-CNP

MDXpress

A lightweight Markdown-powered blogging platform. Framework-agnostic, no CMS or database required.

Framework
Use Case
CSS
Contentful thumbnail for MDXpress-Blog-CNP

🚀 MDXpress Blog - CNP (Compiled N' Portable)

MDXpress Blog - CNP is a serverless-friendly version of the original MDXpress Blog, reworked to deploy seamlessly on platforms like Vercel using Serverless Functions.

It’s a markdown-powered, minimal blogging platform that compiles content on-the-fly without any backend server, database, or complex setup.

✨ What's New in CNP?

  • Serverless Architecture: Powered by Vercel Serverless Functions.
  • 🪄 Vercel-Ready: No server.js, works natively with vercel dev and on production deploys.
  • 📁 /api Directory Support: Each route is handled through functions inside the /api/ folder.
  • ⚙️ Markdown Compilation: Still powered by marked, now running serverlessly.
  • 💅 Same UI, Better Delivery: No compromises on theming, dark mode, or user experience.

📁 Project Structure

mdxpress-blog-cnp/
├── api/ # Serverless function handlers
│ ├── index.js # Homepage rendering
│ ├── blog.js # Blog listing route
│ └── blog/[slug].js # Dynamic blog rendering
├── public/
│ ├── blogs/ # Markdown files for each blog post
│ ├── styles/ # CSS with dark mode support
│ └── views/ # HTML templates
├── vercel.json # Vercel routing and config
├── package.json # Metadata and dependencies
└── README.md # This file

🧪 How to Run Locally

  1. Clone the Repository

    git clone https://github.com/eshan-singh78/MDXpress-Blog
    cd MDXpress-Blog-CNP
  2. Install Dependencies

    npm install
  3. Run Locally with Vercel

    vercel dev
  4. Visit the App Open http://localhost:3000 in your browser.

📌 How It Works on Vercel

  • All backend logic is handled via Serverless Functions in /api.
  • Static assets (styles, markdown files) are served from /public.
  • HTML templates are combined with rendered Markdown and returned as HTML.

🙋‍♂️ About the Creator

Crafted by Eshan Singh, a full-stack developer & cybersecurity enthusiast exploring the balance of performance and simplicity in web apps.

Looking to contribute, request features, or report issues? Feel free to open a PR or issue!

Contentful thumbnail for MDXpress-Blog-CNP
Avatar of eshan-singh78eshan-singh78/MDXpress-Blog-CNP

MDXpress

A lightweight Markdown-powered blogging platform. Framework-agnostic, no CMS or database required.

Framework
Use Case
CSS

🚀 MDXpress Blog - CNP (Compiled N' Portable)

MDXpress Blog - CNP is a serverless-friendly version of the original MDXpress Blog, reworked to deploy seamlessly on platforms like Vercel using Serverless Functions.

It’s a markdown-powered, minimal blogging platform that compiles content on-the-fly without any backend server, database, or complex setup.

✨ What's New in CNP?

  • Serverless Architecture: Powered by Vercel Serverless Functions.
  • 🪄 Vercel-Ready: No server.js, works natively with vercel dev and on production deploys.
  • 📁 /api Directory Support: Each route is handled through functions inside the /api/ folder.
  • ⚙️ Markdown Compilation: Still powered by marked, now running serverlessly.
  • 💅 Same UI, Better Delivery: No compromises on theming, dark mode, or user experience.

📁 Project Structure

mdxpress-blog-cnp/
├── api/ # Serverless function handlers
│ ├── index.js # Homepage rendering
│ ├── blog.js # Blog listing route
│ └── blog/[slug].js # Dynamic blog rendering
├── public/
│ ├── blogs/ # Markdown files for each blog post
│ ├── styles/ # CSS with dark mode support
│ └── views/ # HTML templates
├── vercel.json # Vercel routing and config
├── package.json # Metadata and dependencies
└── README.md # This file

🧪 How to Run Locally

  1. Clone the Repository

    git clone https://github.com/eshan-singh78/MDXpress-Blog
    cd MDXpress-Blog-CNP
  2. Install Dependencies

    npm install
  3. Run Locally with Vercel

    vercel dev
  4. Visit the App Open http://localhost:3000 in your browser.

📌 How It Works on Vercel

  • All backend logic is handled via Serverless Functions in /api.
  • Static assets (styles, markdown files) are served from /public.
  • HTML templates are combined with rendered Markdown and returned as HTML.

🙋‍♂️ About the Creator

Crafted by Eshan Singh, a full-stack developer & cybersecurity enthusiast exploring the balance of performance and simplicity in web apps.

Looking to contribute, request features, or report issues? Feel free to open a PR or issue!

Unleash New Possibilities

Deploy your app on Vercel and unlock its full potential