MDXpress Blog - CNP

MDXpress Blog - CNP is a serverless-friendly version of the original MDXpress Blog, reworked to deploy on Vercel using Serverless Functions. It is a markdown-powered, minimal blogging platform that compiles content on-the-fly without any backend server, database, or complex setup.

What is MDXpress Blog - CNP?

MDXpress Blog - CNP is a blog template that takes Markdown files as input and produces rendered HTML pages as output. It runs on Vercel's serverless infrastructure, with each route handled by a function in the /api directory. The template is created by Eshan Singh, a full-stack developer and cybersecurity enthusiast, and is available on GitHub under the repository eshan-singh78/MDXpress-Blog.

Key Features

• Serverless Architecture — Backend logic is handled via Vercel Serverless Functions; no server.js or persistent server is needed.
• Vercel-Ready — Works natively with vercel dev for local development and deploys directly to Vercel's production environment.
• /api Directory Support — Each route is a serverless function: api/index.js for homepage rendering, api/blog.js for blog listing, and api/blog/[slug].js for dynamic blog post rendering.
• Markdown Compilation — Blog posts are written in Markdown and compiled using the marked library, now running serverlessly.
• Static Assets — CSS with dark mode support and HTML templates are served from the /public directory.
• Same UI as Original — Retains theming, dark mode, and user experience from the original MDXpress Blog.
• Minimal Setup — No database or complex configuration; just Markdown files and serverless functions.

Who is it for?

• Developers who want a simple blog — Use Markdown files to write posts and deploy on Vercel without managing a database or backend.
• Vercel users — Leverage Vercel's serverless functions and static hosting for a fast, low-maintenance blog.
• Markdown enthusiasts — Write content in Markdown and have it compiled on-the-fly into HTML.
• Learners exploring serverless — Study a minimal example of a serverless blogging platform.

What can you do with MDXpress Blog - CNP?

• Deploy a personal blog: Clone the repository, add Markdown posts in public/blogs, and deploy to Vercel for a serverless blog.
• Customize the theme: Modify CSS files in public/styles to change the appearance, including dark mode support.
• Extend with serverless functions: Add new routes by creating additional files in the api directory.

How does MDXpress Blog - CNP work?

1. Clone the repository and run npm install.
2. Start the local development server with vercel dev.
3. Visit http://localhost:3000 to view the blog.
4. On Vercel, serverless functions handle routing, read Markdown files from public/blogs, compile them with marked, and combine with HTML templates from public/views to return rendered pages.

FAQ

Is MDXpress Blog - CNP free?

Yes, MDXpress Blog - CNP is an open-source template available on GitHub. It is free to use and modify. However, deploying on Vercel may incur costs depending on your usage of their serverless functions and bandwidth.

Do I need a database to use MDXpress Blog - CNP?

No, MDXpress Blog - CNP does not require a database. Blog posts are stored as Markdown files in the public/blogs directory. The content is compiled on-the-fly by serverless functions, eliminating the need for a persistent data store.

What platform does MDXpress Blog - CNP run on?

MDXpress Blog - CNP is designed to run on Vercel using Serverless Functions. It can be developed locally with vercel dev and deployed to Vercel's production environment. It is not tied to other platforms.

Can I use MDXpress Blog - CNP with other hosting providers?

MDXpress Blog - CNP is specifically built for Vercel's serverless functions and routing configuration. While the core logic could be adapted, it is not designed for other platforms out of the box. The vercel.json file contains routing and configuration specific to Vercel.