Skip to content
Back to Templates

MDXpress

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

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!