The markItUp! universal markup editor, bundled for Rails 3.1+ Asset Pipeline.
Ruby JavaScript CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
vendor/assets Allow multiple settings objects to be used within a single page Jun 26, 2013
.gitignore update .gitignore Jan 7, 2013
.ruby-gemset update .ruby-(version|gemset) Jun 24, 2013
Rakefile update engine: Jan 7, 2013
markitup-rails.gemspec update development dependencies Jun 24, 2013



The markItUp! universal markup editor, bundled for Rails 3.1+ Asset Pipeline.

markItUp! is a JavaScript plug-in built on the jQuery library. It allows you to turn any textarea into a markup editor. HTML, Textile, Wiki Syntax, Markdown, BBcode or even your own Markup system can be easily implemented.

markitup-rails ships with several markup "sets" and editor "skins" including:

Markup Sets

  • bbcode
  • css
  • default
  • dotclear
  • html
  • markdown
  • markmin
  • rest
  • textile
  • texy
  • txt2tags
  • wiki
  • xbbcode

Editor Skins

  • markitup
  • simple


This gem requires Rails 3.1+ and has been tested on the following versions:

  • 3.1
  • 3.2

This gem requires Ruby 1.9+ and has been tested against the following Ruby versions:

  • 1.9.2
  • 1.9.3
  • JRuby
  • Rubinius


Add this line to your application's Gemfile:

gem "markitup-rails"

And then execute:

$ bundle

Or install it yourself as:

$ gem install markitup-rails


The Markitup::Rails module accepts a configure block with options to customize the engine behavior.

Place any custom configuration in a file such as config/initializers/markitup_rails.rb.


Set the layout option to customize the layout used by the AJAX live preview:

Markitup::Rails.configure do |config|
  config.layout = "other"  # default is `markitup`

You may also override the default locally by creating a new layout file at app/views/layouts/markitup.html.erb.


Set the formatter option to customize the renderer for the preview. This can be any object that responds to call and which takes a single argument with the markup to render:

Markitup::Rails.configure do |config|
  config.formatter = -> markup { BBCodeParser.parse(markup) }


markitup-rails provides a URL endpoint that be mounted to support a live server-side preview of markItUp! content.

To enable, mount the engine in your config/routes.rb file:

mount Markitup::Rails::Engine, at: "markitup", as: "markitup"

This will create a URL helper for markitup.preview_url which will route to /markitup/preview.

The preview URL will render the editor content using the config.formatter and display the content within the config.layout.


For Rails 3.1 and greater, the files will be added to the asset pipeline and available for you to use.

To enable the markItUp! editor in your application, you will need to include the appropriate JavaScript and Stylesheet files for the Set and Skin you wish to use.


  • Add the following line to the file app/assets/javascripts/application.js (or other sprockets manifest):
//= require markitup
//= require markitup/sets/xbbcode/set
  • Add the following line to the file app/assets/stylesheets/application.css:
*= require markitup/skins/markitup/style
*= require markitup/sets/xbbcode/style

You may also include the styles in your SCSS file directly:

@import "markitup/skins/markitup/style";
@import "markitup/sets/xbbcode/style";

Using markItUp!


jQuery ->

  # Target all text areas
  $("textarea").markItUp mySettings

  # Target a specific ID
  $("#my_id").markItUp mySettings

  # Target a specific class
  $("textarea.markitup").markItUp mySettings

See the markItUp! documentation for more information.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a Pull Request


Many thanks go to the following who have contributed to making this gem even better:

  • @uri
    • initial version
  • @phlipper
    • complete rewrite as an engine for Rails 3.1+
    • add AJAX live preview support
    • add support for Sets and Skins, add many defaults to choose from
  • @ilja
    • update markitup to version 1.1.14
  • @zinenko
    • fix invalid images url in simple skin
  • @tamaloa
    • added default /markitup/preview path to all default settings
  • @tgjones
    • allow multiple settings objects to be used within a single page




markItUp! is released under both the MIT and GPL Open Source licenses. In short, this means that markItUp! is totally Free, and you can do whatever you want with it. You are only obligated to keep the credits in place.