Metadata-Version: 2.0
Name: ghmarkdown
Version: 0.1.9
Summary: ghmarkdown is the complete command-line tool for GitHub-flavored markdown
Home-page: http://github.com/lukedmor/ghmarkdown
Author: Lucas Morales
Author-email: lucasem@mit.edu
License: GNU GPL v2.0
Keywords: markdown live html github command command-line cli
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Text Processing :: Markup
Classifier: Topic :: Text Processing :: Markup :: HTML
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4

ghmarkdown
==========

The complete command-line tool for GitHub-flavored markdown. It provides a convenient interface for the API provided by GitHub.

ghmarkdown's `--serve` feature let's you locally view your markdown **live**, so you can view your changes as you work!

.. figure:: http://i.imgur.com/WUCWpOM.gif
   :alt: example usage gif

Features
--------

-  Host your markdown locally to easily view your changes *as you make them*!
-  Easy to `install <https://github.com/lukedmor/ghmarkdown#installation>`__
-  Easy to `use <https://github.com/lukedmor/ghmarkdown#usage>`__
-  Works on Mac, Linux and Windows

Installation
------------

.. code:: bash

    $ pip install ghmarkdown


Usage
-----

Run your markdown on a local server:

.. code:: bash

    # these do the same thing
    $ ghmarkdown -si my_file.md
    $ ghmarkdown --serve --input my_file.md
    $ cat my_file.md | ghmarkdown --serve # doesn't update changes


Parse your markdown to HTML locally:

.. code:: bash

    # these do the same thing
    $ ghmarkdown -i my_file.md -o my_page.html
    $ ghmarkdown --input my_file.md --output my_page.html
    $ cat my_file.md | ghmarkdown > my_page.html


Use ``ghmarkdown --help`` to see all available commands and parameters

GitHub limits usage of its api, so if you want more than 60 req/hr use ``--login`` (you'll get 5000 req/hr!)


