Cómo usar markdown en Rails

Me encanta markdown. Tiene una sintaxis fácil de aprender y convive muy bien con texto existente en HTML. Es un buen lenguaje para foros o blogs, ya que permite dar formato de forma sencilla sin necesidad de saber HTML.

Recientemente quería usar markdown para un proyecto que estoy haciendo con Rails. El framework ofrece un método para trabajar directamente con markdown, pero es necesario tener instalada una librería externa a Rails. En mi caso opté por BlueCloth.

Para usar bluecloth basta con instalar la gema

$ sudo gem install bluecloth

NOTA: en algunas guías he visto el comando sudo gem install BlueCloth en vez de bluecloth. RubyGems es sensible a mayúsculas y minúsculas y al usar BlueCloth se instala una versión antigua de la gema.

Haciendo que Rails reconozca bluecloth

Para que Rails permita usar el método markdown debemos indicarle que queremos usar bluecloth. Para ello modificamos el fichero config/environment.rb

Rails::Initializer.run do |config|
  ...
  config.gem "bluecloth"
  ...
end

Reiniciamos el servidor de desarrollo para que reconozca nuestros cambios y voila! Usar markdown en nuestras vistas es tan simple como llamar al helper markdown

<!-- cosas... -->
<%= markdown variable %>
<!-- otras cosas... -->