[kramdown-users] [ANN] kramdown 0.14.0

Thomas Leitner t_leitner at gmx.at
Sun Sep 16 06:17:40 UTC 2012


## About kramdown

kramdown (sic, not Kramdown or KramDown, just kramdown) is a *free*
GPL-licensed [Ruby](http://www.ruby-lang.org) library for parsing a
superset of Markdown. It is completely written in Ruby, supports
standard Markdown (with some minor modifications) and various
extensions that have been made popular by the PHP Markdown Extra
package and Maruku.

Homepage for installation instructions and documentation:
   http://kramdown.rubyforge.org


## kramdown 0.14.0 released

First of all please note that this release contains a
**backwards-incompatible** change: The syntax for specifying a code
language for a code block or code span has changed. Instead of using
`lang='CODELANG'` one has to use `.language-CODELANG` now.

This change has been introduced to avoid problems because the
`lang="..."` attribute is used by HTML for other purposes than setting
the code language. Furthermore using `.language-CODELANG` is also
proposed by HTML5 and it seems to be a good way to achieve the needed
functionality.

Other changes in this release include the possibility of setting the
code language on the starting line of a fenced code block and a way of
excluding certain headers from the table of contents by assigning the
`.no_toc` class to them.

## Changes

* 2 major changes

  - Code language is now specified via `.language-CODELANG` instead of
    `lang='CODELANG'`
  - Implemented support for setting language on fenced code block
    starting line (initial patch by Bran)

* 1 minor change

  - Headers with an ID can be prevented from showing in the TOC by
    assigning the `.no_toc` class to them (patch by Tim Bates)

* 1 bug fix

  - Numeric instead of symbolic HTML entities are now the default
    fallback (patch by Gioele Barabucci)


More information about the kramdown-users mailing list