T
Thomas Leitner
## 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.11.0 released
The biggest change in this release is the implementation of the "lazy
syntax" which allows one to not use the correct indent or block marker
and still continue a paragraph, blockquote, ... The original Markdown
syntax allows this and it was requested that kramdown allows this, too.
However, the main reason for adding this syntax to kramdown is not to
encourage authors to be lazy but to allow kramdown texts to be
hard-wrapped by other applications (think, for example, email
programs). Therefore you shouldn't make active use of this feature when
creating a kramdown document!
Another important, though minor, change is that invalid HTML tags and
extensions are not removed anymore. This is done because of the general
rule that unrecognized elements are treated as simple text.
**Note**: The "internal" API (which is currently everything except the
`Kramdown:
ocument` class) has changed and developers may therefore
need to update their extensions!
## Changes
* 3 major changes:
- Line wrapping a.k.a. "lazy syntax" is now supported (requested by
Shawn Van Ittersum)
- Link URLs in inline links and link definitions may now also contain
spaces, even if not enclosed in angle brackets (requested by Matt
Neuburg)
- The kramdown converter produces nicer output, using the new option
`line_width`
* 9 minor changes:
- The HTML converter does not escape the quotation mark in code
blocks anymore (requested by Matt Neuburg)
- The order of HTML attributes and attributes defined via IALs and
ALDs is now preserved (requested by Matt Neuburg)
- Syntax highlighting is now supported in code spans when using the
HTML converter (requested by Josh Cheek)
- Updated `nomarkdown` extension and converters to support
restricting the output to certain or all converters
- Colons are now allowed in ID names for ALDs and IALs
- Tables and math blocks now have to start and end on block boundaries
- The table syntax was relaxed to allow table lines that don't start
with a pipe character (to be more compatible with PHP Markdown
Extra tables)
- HTML elements `<b>` and `<i>` are now converted to `<strong>` and
`<em>` when using HTML-to-native conversion
- The `document.html` template now uses the text of the first
not-nested header as title text
* 9 bug fixes:
- The LaTeX converter now removes trailing whitespace in footnotes
(reported by Michael Franzl)
- Fixed bug RF#28429: HTML output of `iframe` HTML element was
invalid (reported by Matthew Riley)
- Fixed bug RF#28420: LaTeX converter shouldn't escape the content of
the `nomarkdown` extension (reported by Bj Wilson)
- Fixed bug RF#28469: HTML "document" template did not work (reported
by Vofa Ethe)
- Fixed bug: HTML/kramdown output of `textarea` HTML element was
invalid (reported by John Muhl)
- Invalid or unknown extension tags are now left alone and not
removed anymore
- Invalid HTML tags are now left alone and not removed anymore
- Fixed a minor problem in list parsing which arised due to compact
nested list detection
- Link/Abbreviation/Footnote definitions as well as extensions, ALDs
and block IALs now work correctly as block separators
* 1 deprecation note:
- The option `numeric_entities` has been removed
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.11.0 released
The biggest change in this release is the implementation of the "lazy
syntax" which allows one to not use the correct indent or block marker
and still continue a paragraph, blockquote, ... The original Markdown
syntax allows this and it was requested that kramdown allows this, too.
However, the main reason for adding this syntax to kramdown is not to
encourage authors to be lazy but to allow kramdown texts to be
hard-wrapped by other applications (think, for example, email
programs). Therefore you shouldn't make active use of this feature when
creating a kramdown document!
Another important, though minor, change is that invalid HTML tags and
extensions are not removed anymore. This is done because of the general
rule that unrecognized elements are treated as simple text.
**Note**: The "internal" API (which is currently everything except the
`Kramdown:
ocument` class) has changed and developers may thereforeneed to update their extensions!
## Changes
* 3 major changes:
- Line wrapping a.k.a. "lazy syntax" is now supported (requested by
Shawn Van Ittersum)
- Link URLs in inline links and link definitions may now also contain
spaces, even if not enclosed in angle brackets (requested by Matt
Neuburg)
- The kramdown converter produces nicer output, using the new option
`line_width`
* 9 minor changes:
- The HTML converter does not escape the quotation mark in code
blocks anymore (requested by Matt Neuburg)
- The order of HTML attributes and attributes defined via IALs and
ALDs is now preserved (requested by Matt Neuburg)
- Syntax highlighting is now supported in code spans when using the
HTML converter (requested by Josh Cheek)
- Updated `nomarkdown` extension and converters to support
restricting the output to certain or all converters
- Colons are now allowed in ID names for ALDs and IALs
- Tables and math blocks now have to start and end on block boundaries
- The table syntax was relaxed to allow table lines that don't start
with a pipe character (to be more compatible with PHP Markdown
Extra tables)
- HTML elements `<b>` and `<i>` are now converted to `<strong>` and
`<em>` when using HTML-to-native conversion
- The `document.html` template now uses the text of the first
not-nested header as title text
* 9 bug fixes:
- The LaTeX converter now removes trailing whitespace in footnotes
(reported by Michael Franzl)
- Fixed bug RF#28429: HTML output of `iframe` HTML element was
invalid (reported by Matthew Riley)
- Fixed bug RF#28420: LaTeX converter shouldn't escape the content of
the `nomarkdown` extension (reported by Bj Wilson)
- Fixed bug RF#28469: HTML "document" template did not work (reported
by Vofa Ethe)
- Fixed bug: HTML/kramdown output of `textarea` HTML element was
invalid (reported by John Muhl)
- Invalid or unknown extension tags are now left alone and not
removed anymore
- Invalid HTML tags are now left alone and not removed anymore
- Fixed a minor problem in list parsing which arised due to compact
nested list detection
- Link/Abbreviation/Footnote definitions as well as extensions, ALDs
and block IALs now work correctly as block separators
* 1 deprecation note:
- The option `numeric_entities` has been removed