Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/davidfstr/rdiscount

Discount (For Ruby) Implementation of John Gruber's Markdown
https://github.com/davidfstr/rdiscount

markdown markdown-parser

Last synced: 3 days ago
JSON representation

Discount (For Ruby) Implementation of John Gruber's Markdown

Awesome Lists containing this project

README

        

Discount Markdown Processor for Ruby
====================================
[![Build Status](https://github.com/davidfstr/rdiscount/actions/workflows/main.yml/badge.svg)](https://github.com/davidfstr/rdiscount/actions/workflows/main.yml)

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][1] and
passes the [Markdown 1.0 test suite][2].

CODE: `git clone git://github.com/davidfstr/rdiscount.git`
HOME:
DOCS:
BUGS:

Discount was developed by [David Loren Parsons][3].
The Ruby extension is maintained by [David Foster][4].

[1]: https://daringfireball.net/projects/markdown/syntax
[2]: https://daringfireball.net/projects/downloads/MarkdownTest_1.0.zip
[3]: https://www.pell.portland.or.us/~orc
[4]: https://github.com/davidfstr

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.

[RubyGems]: https://rubygems.org/gems/rdiscount
[BUILDING]: https://github.com/davidfstr/rdiscount/blob/master/BUILDING

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.