can design 2.7

New Radiant Markdown Extension using RDiscount

You can always find the latest information on the Radiant Markdown Extension page

Download

You can either git clone from github or download a tarball. (make sure the path is /your/radiant/app/vendor/extensions/markdown_filter)

Demo

BlueCloth vs. RDiscount

Requirements

You need to have the RDiscount gem installed. Since RDiscount needs to compile some binaries it’s not really possible to distribute it with the extension.

gem install rdiscount

Everything else

I needed an implementation of Markdown that followed the full syntax, and did so consistently. For example, in BlueCloth **1%** yields the HTML <em>*1%*</em> however, in RDiscount it correctly yields <strong>1%</strong>. Eventually you get tired of explaining to clients that even though they typed it in exactly right the content management system you provided them doesn’t understand it, and instead they need to type out the actual HTML.

This extension still uses Smarty Pants for nice punctuation. Installing it will automatically override the built-in (BlueCloth) Markdown so you don’t need to change the filter on your pages. You can tell the extension is properly installed when you see (RDiscount) at the end of the extension description in the Extensions tab of the admin interface.

2008/06/27