/ 
Markdent-0.12
River stage two • 5 direct dependents • 14 total dependents
/ Mardent::Dialect::Standard

NAME

Mardent::Dialect::Standard

VERSION

version 0.12

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.

  • Currently Markdent does not look for two trailing spaces at the end of a paragraph line. In the Standard dialect, these indicate an intentional line break.

    This will probably be fixed in a future release.

  • 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.

NAME

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

BUGS

See Markdent for bug reporting details.

AUTHOR

Dave Rolsky, <autarch@urth.org>

COPYRIGHT & LICENSE

Copyright 2009-2010 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.

AUTHOR

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Dave Rolsky.

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