---
title: "MDXpress"
description: "A lightweight Markdown-powered blogging platform. Framework-agnostic, no CMS or database required."
url: "https://vercel.com/templates/other/mdxpress"
links:
  repository: "https://github.com/eshan-singh78/MDXpress-Blog-CNP"
  demo: "https://mdxpress-blog-cnp.vercel.app/"
  deploy: "https://vercel.com/new/clone?demo-title=MDXpress&demo-description=A+lightweight+Markdown-powered+blogging+platform.+Framework-agnostic%2C+no+CMS+or+database+required.&demo-url=https%3A%2F%2Fmdxpress-blog-cnp.vercel.app%2F&demo-image=%2F%2Fimages.ctfassets.net%2Fe5382hct74si%2F3n4PZFjtFE8p0tezxTMeEe%2Fdf8aa144c3ac48b9275c8ed13007d2e8%2FScreenshot-2025-04-23-at-4-31-57-PM.png&project-name=MDXpress&repository-name=mdxpress&repository-url=https%3A%2F%2Fgithub.com%2Feshan-singh78%2FMDXpress-Blog-CNP&from=templates&skippable-integrations=1"
---

# MDXpress

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

# 🚀 MDXpress Blog - CNP (Compiled N' Portable)

**MDXpress Blog - CNP** is a serverless-friendly version of the original [MDXpress Blog](https://github.com/eshan-singh78/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**
   ```bash
   git clone https://github.com/eshan-singh78/MDXpress-Blog
   cd MDXpress-Blog-CNP
   ```

2. **Install Dependencies**
   ```bash
   npm install
   ```

3. **Run Locally with Vercel**
   ```bash
   vercel dev
   ```

4. **Visit the App**
   Open [http://localhost:3000](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](mailto:eshan.singh.04.dev@gmail.com), 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!

## Related Templates

### [Blog Starter Kit](https://vercel.com/templates/next.js/blog-starter-kit)

A statically generated blog example using Next.js and Markdown.

### [Tailwind CSS Blog](https://vercel.com/templates/next.js/tailwind-css-starter-blog)

Next.js blog using Markdown for content.

### [Docus](https://vercel.com/templates/nuxt/docus)

Markdown-based documentation starter with Nuxt and Vue components.

---

## Additional documentation

The [Vercel Knowledge Base](https://vercel.com/kb) contains guides and answers to common questions about Vercel, including deployment, framework configuration, domains, caching, and troubleshooting.