node package manager


Serve your Markdown files over HTTP


Serves Markdown files over HTTP.

No magic, just serves static files out of a directory. If a file is a .md file, it will render the Markdown into HTML. It will serve or index.html when a directory is requested if either exist.

By default the Bootstrap (v2.3.1) CSS file is linked to the generated HTML documents. Markdown is parsed by the marked library.

I made this project because I wanted the easiest way to preview documentation files that would be uploaded to Github. Many existing utilities change the file name (e.g. request test.html for the file) or are too hard to setup. Note that this is probably not secure, it is not meant for development purposes.


Install using NPM: npm install servemd -g


servemd &                   # Starts the server on port 3000 
curl http://localhost:3000/ # Get the contents of the file rendered 


servemd -d ~/           # Serves files from specified directory 
servemd -p 1234         # Listens on the specified port 
servemd -s mystyles.css # Link the specified CSS file to the HTML 
servemd --help          # Get more help 


It currently does not do any syntax highlighting.