Skip to content

aheckmann/greadme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

84 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

greadme

Locally preview your markdown, Github style.

greadme screenshot

Installation

via npm:

$ npm install -g greadme

Usage

$ greadme [path/to/some.markdown]

   view your markdown at http://localhost:8124/
   press CTRL+C to quit

Execute greadme passing an optional path to a markdown file and it will be parsed and served from a locally running http server with Github styling applied. When no file path is specified, greadme displays a file browser of the current directory, similar to Github.

A browser will automatically be opened to preview the markdown if your OS supports it.

Files with the following extensions are rendered.

  • .md
  • .markdown

The default port is 8124 and the default host is localhost. You can change these settings by passing the --port and --host option. For example:

$ greadme --host 127.0.0.0 --port 7220

Notes

An attempt is made to use the Github markdown rendering api and Githubs stylesheets. If the attempt fails we fall back to rendering locally.

Contributors

https://github.com/aheckmann/greadme/graphs/contributors

License

MIT

About

Locally preview your markdown, Github style

Resources

License

Stars

Watchers

Forks

Contributors