Skip to content

A minimal blog platform where users upload markdown files, push the repo, and it's live instantly.

Notifications You must be signed in to change notification settings

eshan-singh78/MDXpress-Blog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📰 MDXpress blog

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.


✨ Features

  • 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 .md files to the repo and they instantly show up in the UI.
  • 💻 Markdown Rendering: Styled and responsive markdown rendering via the marked library.

📂 Project Structure

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

📝 How to Use

  1. Clone the Repository

    git clone https://github.com/yourusername/mdxpress-blog.git
  2. Add Blog Posts
    Drop your .md files inside the public/blogs/ directory.

  3. Run Locally

    npm install
    npm start
  4. Visit in Browser
    Open http://localhost:3000 to view your home page and blogs.


🙋‍♂️ About the Creator

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!

About

A minimal blog platform where users upload markdown files, push the repo, and it's live instantly.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published