The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Markdent::Dialect::Standard - Markdown as defined by John Gruber

SYNOPSIS

  use Markdent::Parser;

  my $parser = Markdent::Parser->new( handler => ... );

DESCRIPTION

The "Standard" dialect is plain Markdown as defined by John Gruber (http://daringfireball.net/projects/markdown/) and as implemented by Dingus (http://daringfireball.net/projects/markdown/dingus).

This is the default dialect, so you do not need to ask for it explicitly.

DEVIATIONS

The Standard dialect as implemented by Markdent differs from Dingus in a few ways:

  • HTML attribute quote delimiters are not preserved, so a single quote may be converted into a double quote.

  • Whitespace on an empty line in a code block is preserved by Markdent, but not by Dingus.

  • Markdent will not generate bad HTML from Markdown markup. Markdent does not allow unbalanced markup events to propagate, and will turn unbalanced events into plain text.

    Here is an example:

      *em **strong* wtf**

    Dingus turns this into:

      <p><em>em <strong>strong</em> wtf</strong></p>

    Markdent's HTML output for the same:

      <p><em>em **strong</em> wtf**</p>

    Note that with inline HTML, Markdent echoes it more or less as-is, so you can still produce bad HTML with Markdent.

BUGS

See Markdent for bug reporting details.

AUTHOR

Dave Rolsky, <autarch@urth.org>

COPYRIGHT & LICENSE

Copyright 2009-2012 Dave Rolsky, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.