greadme

3.0.0 • Public • Published

greadme

Locally preview your markdown, Github style.

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

Package Sidebar

Install

npm i greadme

Weekly Downloads

6

Version

3.0.0

License

MIT

Unpacked Size

589 kB

Total Files

12

Last publish

Collaborators

  • aaron
  • domenic
  • forbeslindesay