jgarber edited this page Oct 3, 2010 · 34 revisions
Clone this wiki locally

About RedCloth

RedCloth is a module for using Textile in Ruby. Textile is a simple text format that can be converted to HTML. It’s used on wikis, blogging engines, bug trackers, this site—pretty much everywhere.

textile to html
_emphasized_ emphasized
*strong* strong
"Ruby on Rails":http://www.rubyonrails.org Ruby on Rails
* an item
* and another
  • an item
  • and another
# one
# two
  1. one
  2. two

Try it out at the RedCloth Textile Dingus


Using RubyGems

$ gem install RedCloth

NB: RedCloth is UpperCamelCase, not lowercase. If you try gem install redcloth you’ll get ERROR: could not find redcloth locally or in a repository.

From source

To install from source, get it from the repository:

$ git clone git://github.com/jgarber/redcloth.git
$ cd redcloth
$ rake install

You’ll need the latest Ragel to compile it.

Textile Reference Manual

The RedCloth Textile Reference Manual can be found on redcloth.org

Bugs and contributions

Bug tracking is on Lighthouse. Please only report bugs about RedCloth 4.0. The 3.0.4 version’s bugs are many and well-known

If you have a change you would like to contribute:

  1. fork on GitHub
  2. git clone your fork
  3. add tests to show how the expected behavior is not occurring
  4. write code until the tests pass
  5. send a pull request on GitHub


Have a question about RedCloth or want to follow its latest developments? Join the mailing list.