MDXpress blog is a lightweight markdown-powered blogging platform built using Node.js. Designed for simplicity and speed, it allows users to post blog entries by simply adding .md files to a specific folderβno CMS or database required.
- β‘ Fast & Minimal: Just write Markdown filesβno database or frontend frameworks.
- ποΈ Automatic Content Loading: Upload your markdown file to the
/public/blogs/folder and itβs live. - π¨ Built-in Dark Mode: Seamless dark/light theme toggle with a clean UI.
- π Auto Updates with Push: Push new
.mdfiles to the repo and they instantly show up in the UI. - π» Markdown Rendering: Styled and responsive markdown rendering via the
markedlibrary.
mdxpress-blog/
βββ public/
β βββ blogs/ # Markdown blog files (.md)
β βββ styles/ # CSS styles including dark mode
β βββ views/ # HTML templates (home, blog viewer)
βββ server.js # Express server with markdown rendering
βββ package.json # Project metadata and dependencies
βββ vercel.json # Vercel configuration
-
Clone the Repository
git clone https://github.com/yourusername/mdxpress-blog.git
-
Add Blog Posts
Drop your.mdfiles inside thepublic/blogs/directory. -
Run Locally
npm install npm start
-
Visit in Browser
Openhttp://localhost:3000to view your home page and blogs.
Created by Eshan Singh, a tech enthusiast and full-stack developer who enjoys building minimal, impactful tools.
Want to contribute, suggest features, or report bugs? Open an issue or submit a pull request!