mfenner / jekyll-pandoc

Jekyll Pandoc markdown converter as Ruby gem
MIT License
82 stars 10 forks source link

jekyll-pandoc

Build Status Gem Version Code Climate

Pandoc markdown converter for the Jekyll static site generator. Originally based on jekyll-pandoc-plugin by David Sanson.

Jekyll-pandoc uses the pandoc-ruby gem as a Ruby wrapper for Pandoc.

Requirements

Install version 1.0.2 for older jekyll versions

Installation

Run bundle install after adding the gem to your Jekyll Gemfile:

gem "jekyll-pandoc"

If you are not using Bundler, install as gem:

[sudo] gem install jekyll-pandoc

Configuration

Add the gem to the Jekyll _config.yml:

gems:
  - jekyll-pandoc

Change the markdown processor in the Jekyll _config.yml:

markdown: Pandoc

Additional pandoc options can be provided in the Jekyll _config.yml:

pandoc:
  extensions:
    - normalize
    - smart
    - mathjax
    - csl: _styles/apa.csl
    - bibliography: bibliography/references.bib

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

MIT License.