No commit activity in last 3 years
No release in over 3 years
Runs a webserver to preview Github markdown with live.js updating.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.7
~> 5.4
~> 10.3

Runtime

 Project Readme

Github Markdown Server

Use your favorite editor to edit a markdown file, Run the server and open the file. Saving in your editor updates instantly in the browser.

github-markdown-server is built on top of github-markdown-preview and live.js.

Gem Version Build Status

Installation

gem install github-markdown-server

Usage

github-markdown-server README.md

This will start a server serving in the current directory and all child directories and open a browser (on a mac) showing README.md converted to html. If you navigate to a directory name only child directories and .md files are shown in a directory listing. If there is a README.md file in that directory it will be appended to the directory listing.

If you are deep down inside a git repository and you want to serve the whole repository (so that relative links will work) then this command will do that for you.

github-markdown-server -d $(git rev-parse --show-toplevel) somefile.md

Contrib

There is a contrib directory with an emacs lisp file which will start a server and open a file for you. It'll keep track of which servers it has started and reuse an existing server if a file you want to preview is under that server's serving directory.

Contributing

Please feel free to send me pull requests! This is my first Ruby project and it always feels like my first time when I write Emacs Lisp.