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!