leebivip / markdown2html

Yet another script that converts GitHub Flavored Markdown files to HTML.

markdown2html

Yet another script that converts GitHub Flavored Markdown files to HTML.

It is inspired by grip, and is an attempt to replicate it without its dependencies and without the need to interact directly with GitHub, or even being connected to the internet. The first time it runs, github-markdown.css is downloaded and stored in ~/.cache and from then on, it can be used while being offline. Generated HTML is put at /tmp by default.

Note that GitHub doesn't use pygments anymore for syntax highlighting, so it's difficult to generate the same CSS classes to use its colorscheme, and pygments doesn't include a similar one. For now, markdown2html uses the tango style which comes built-in with pygments.

Requirements

• markdown
• pygments
• docopt

Install with:

$ pip install markdown pygments docopt

Usage

markdown2html.py [options] <file>

Options:
  -o, --out <file>  Write output to <file>
  -f, --force       Overwrite existing CSS file
  -p, --preview     Open generated HTML file in browser
  -q, --quiet       Show less information
  -h, --help        Show this help message and exit

License

Licensed under GPLv3.