ghmarkdown is the complete command-line tool for GitHub-flavored markdown
Project description
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!
Features
Installation
pip install ghmarkdown
Usage
Run your markdown on a local server:
# 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:
# 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
See all features and parameters:
$ ghmarkdown --help usage: ghmarkdown [--help | --version] [--login] [--bare] [--silent] [--input MD] [--output HTML | --serve [--port PORT]] The complete command-line tool for GitHub-flavored markdown optional arguments: -h, --help show this help message and exit --version --input MD, -i MD input markdown file (otherwise STDIN) --output HTML, -o HTML output html file (otherwise STDOUT) --login, -l allows for more requests --bare, -b disable standalone html (gives fragment) --silent, -q silences server output and rate information --serve, -s locally serve parsed markdown --port PORT, -p PORT
GitHub limits usage of its api, so if you want more than 60 req/hr use --login (you’ll get 5000 req/hr!)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ghmarkdown-1.0.4.tar.gz
(8.7 kB
view hashes)
Built Distribution
ghmarkdown-1.0.4-py2-none-any.whl
(10.9 kB
view hashes)
Close
Hashes for ghmarkdown-1.0.4-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a2d45716e9dc71e6a620b4ced5359552cfc7c96b574466557649bea5ebcc96f5 |
|
MD5 | 98fec926332e9ac695f65cea9e3233ee |
|
BLAKE2b-256 | e106c560d35aaf1b24d08c1c4ef17ff0934bee047b7bdc27c52b8080c04971af |