Project

gfm

0.0
No commit activity in last 3 years
No release in over 3 years
Generates an HTML file from a GitHub Flavored Markdown file. Useful for previewing README files.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 3.3

Runtime

 Project Readme

GFM Preview

Gem Version gfm API Documentation

This gem takes a markdown file and parses it with GitHub Flavored Markdown. The generated HTML file gives a preview of the file as it would appear on GitHub. This is useful for checking the format of README.md files before pushing to your remote repository.

Installation

Install with RubyGems:

$ gem install gfm

You may need to install libicu-dev and cmake first. For Ubuntu:

$ sudo apt-get install libicu-dev
$ sudo apt-get install cmake

Usage

$ gfm README.md

This generates a file named README.html, which will give a preview of the README as it would appear on GitHub.

To use a name for the HTML file other than the name of the current file:

$ gfm README.md output

This will generate a file named output.html.

Acknowledgements

Thanks to the creators of ghpreview for the inspiration to write the gfm gem. Check out their page if you would like something more comprehensive. The gfm gem is much smaller but serves my own purposes better.