Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
The code we use to render README.your_favorite_markup
Ruby Python Perl CoffeeScript Shell
Pull request Compare This branch is 1 commit ahead, 115 commits behind github:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
lib
script
test
.gitignore
.kick
.travis.yml
CONTRIBUTING.md
Gemfile
HISTORY.md
LICENSE
README.md
Rakefile
github-markup.gemspec

README.md

GitHub Markup

We use this library on GitHub when rendering your README or any other rich text file. The generated HTML is then run through filters in the html-pipeline to perform things like sanitization and syntax highlighting.

Markups

The following markups are supported. The dependencies listed are required if you wish to run the library. You can also run script/bootstrap to fetch them all.

Installation

gem install github-markup

Usage

require 'github/markup'
GitHub::Markup.render('README.markdown', "* One\n* Two")

Or, more realistically:

require 'github/markup'
GitHub::Markup.render(file, File.read(file))

HTML sanitization

HTML rendered by the various markup language processors gets passed through an HTML sanitization filter for security reasons. HTML elements not in the whitelist are removed. HTML attributes not in the whitelist are removed from the preserved elements.

The following HTML elements, organized by category, are whitelisted:

  • Headings: h1, h2, h3, h4, h5, h6, h7, h8
  • Prose: p, div, blockquote
  • Preformatted: pre
  • Inline: b, i, strong, em, tt, code, ins, del, sup, sub, kbd, samp, q, var
  • Lists: ol, ul, li, dl, dt, dd
  • Tables: table, thead, tbody, tfoot, tr, td, th
  • Breaks: br, hr
  • Ruby (East Asian): ruby, rt, rp

The following attributes, organized by element, are whitelisted:

  • a: href (http://, https://, mailto://, github-windows:// and github-mac:// URI schemes and relative paths only)
  • img: src (http:// and https:// URI schemes and relative paths only)
  • div: itemscope, itemtype
  • all: abbr, accept, accept-charset, accesskey, action, align, alt, axis, border, cellpadding, cellspacing, char, charoff, charset, checked, cite, clear, cols, colspan, color, compact, coords, datetime, dir, disabled, enctype, for, frame, headers, height, hreflang, hspace, ismap, label, lang, longdesc, maxlength, media, method, multiple, name, nohref, noshade, nowrap, prompt, readonly, rel, rev, rows, rowspan, rules, scope, selected, shape, size, span, start, summary, tabindex, target, title, type, usemap, valign, value, vspace, width, itemprop

Note that the id attribute is not whitelisted.

Contributing

See Contributing

Something went wrong with that request. Please try again.