octodown

Ever wanted to easily preview what your markdown would look like exactly on Github? Ever wanted to do that from inside of a Terminal? Well this Gem is for you. Dead simple. Never get caught writing ugly markdown again.

Octodown uses the same parsers and CSS that Github uses for their markdown rendering. Github markdown styling looks beautiful, so it is Octodown's primary goal to reproduce it as faithfully as possible.

---

Features

• Uses the same markdown parsers and CSS as Github for true duplication.

  • Yes emojis are included. 😈

• Fast. octodown uses native parsers to ensure performance.

• Multiple CSS styles.

  • octodown --style atom README.md
  • The --github markdown (default)
  • The --atom text editor markdown

• Properly parses STDIN.

  • cat README.md | octodown

Installation

1. Install icu4c and cmake:

• Mac: brew install icu4c cmake pkg-config
• Apt: sudo apt-get install -y libicu-dev cmake pkg-config

1. Install octodown:

• If you have a non-system Ruby (highly recommended): gem install octodown
• Else: sudo gem install octodown

1. Install in VIM (optional):

• Use Dispatch and add this to your ~/.vimrc:

  " Use octodown as default build command for Markdown files
  autocmd FileType markdown let b:dispatch = 'octodown %'

• Caveat: make sure you follow the directions on the Dispatch README.md and make sure that the correct version of Ruby (the one which as Octodown install as a Gem), is used.

Usage

1. Basic:

• octodown README.md

1. Markdown preview styling:

• octodown --style atom README.md

1. *nix lovers:

• echo '# Hello world!' | octodown --raw > index.html

Notes

1. With no arguments given, octodown will read STDIN until EOF is reached.

• In order to work with this mode, type what you want into the input, then press Ctrl-D when finished.

1. octodown attempts to use default OS support for opening HTML files from terminal. In Mac, this would be the open command; for Linux it is either xdg-open or x-www-browser. If these are not set, octodown will not automatically open the file in the browser. If octodown doesn't have the commands necessary to open files in a browser, please consider opening a pull request to add support!

Contributing

1. Fork it ( https://github.com/ianks/octodown/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Run the test suite (bundle exec rake)
5. Push to the branch (git push origin my-new-feature)
6. Create a new Pull Request