Skip to content

davidfstr/rdiscount

Repository files navigation

Discount Markdown Processor for Ruby

Build Status

Discount is an implementation of John Gruber's Markdown markup language in C. It implements all of the language described in the markdown syntax document and passes the Markdown 1.0 test suite.

CODE: git clone git://github.com/davidfstr/rdiscount.git
HOME: https://dafoster.net/projects/rdiscount/
DOCS: https://rdoc.info/github/davidfstr/rdiscount/master/RDiscount
BUGS: https://github.com/davidfstr/rdiscount/issues

Discount was developed by David Loren Parsons. The Ruby extension is maintained by David Foster.

INSTALL, HACKING

New releases of RDiscount are published to RubyGems:

$ [sudo] gem install rdiscount

The RDiscount sources are available via Git:

$ git clone git://github.com/davidfstr/rdiscount.git
$ cd rdiscount
$ rake --tasks

See the file BUILDING for hacking instructions.

USAGE

RDiscount implements the basic protocol popularized by RedCloth and adopted by BlueCloth:

require 'rdiscount'
markdown = RDiscount.new("Hello World!")
puts markdown.to_html

Additional processing options can be turned on when creating the RDiscount object:

markdown = RDiscount.new("Hello World!", :smart, :filter_html)

Inject RDiscount into your BlueCloth-using code by replacing your bluecloth require statements with the following:

begin
  require 'rdiscount'
  BlueCloth = RDiscount
rescue LoadError
  require 'bluecloth'
end

COPYING

Discount is free software; it is released under a BSD-style license that allows you to do as you wish with it as long as you don't attempt to claim it as your own work. RDiscount adopts Discount's license verbatim. See the file COPYING for more information.