Carpetbomb

Markdown and erb template handler for Ruby on Rails using Redcarpet.

It depends on Redcarpet v3.1

It works from Rails 4.1 to Rails 3.x.

Add to your project Gemfile:

$ gem 'carpetbomb'

Run the following command to install it:

$ bundle install

Run the generator:

$ rails generate carpetbomb:install

That's it.

Run the generator:

$ rails generate carpetbomb:uninstall

Remove the gem from the Gemfile, and run bundle.

This gem adds three posible markdown template extensions to the existing Rails template handlers:

.md, .mdown and .markdown all of them will work and will be parsed first with Ruby on Rails erb template, so you can add whatever erb syntax you want. After that it will be parsed by Redcarpet to handle the markdown part.

It's really simple to start using markdown templates. Create a view or rename it to whatever viewname you want {viewname}.html.md and that's it.

index.html.md

<%= content_for :page_title, 'MyApp - Index' %>

# Hi from the index page.

This is the home directory!

The configuration file for this gem in installed when you use the rails generate carpetbomb:install command, and it's located in config/initializers/carpetbomb.rb. You can change any Redcarpet options within that file.

You can check those options here.

Just send a pull request!

Thanks to Lindsey Bieda for this tutorial and to Joliss for her markdown-rails I practically copied the core of gem.