Text::Markdown::DiscouUserpContributed Perl DocumText::Markdown::Discount(3pm)
NAME
Text::Markdown::Discount - fast function for converting markdown to
HTML (requires C compiler)
SYNOPSIS
use Text::Markdown::Discount;
my $html = markdown($text)
DESCRIPTION
Text::Markdown::Discount is a perl interface to the "Discount" library,
a C implementation of John Gruber's "markdown".
It is the fastest of the Perl modules available for converting
markdown: see the list in "SEE ALSO". It passes Gruber's Markdown
testsuite.
Given that the performance of Discount, Text::Markdown::Discount
processes markdown formatted text quickly and passes the Markdown test
suite at
The interface of the "markdown()" function in this module is not
compatible with the "markdown()" function in Text::Markdown.
EXPORT
markdown is exported by default.
FUNCTION
"Text::Markdown::Discount::with_html5_tags()"
This function enables html5 block-level elements support.
"Text::Markdown::Discount::markdown()" will handle these html5 tags
as block elements: aside, footer, header, hgroup, nav, section,
article.
NOTE: There is no way to disable/re-enable this feature in one
process right now.
use Text::Markdown::Discount;
Text::Markdown::Discount::with_html5_tags();
my $html = markdown('<article>content</article>');
#
# In $html, <article> tag won't be wrapped with <p> tag
SEE ALSO
There are other modules on CPAN for converting Markdown:
• Text::Markdown is a pure-perl markdown converter.
• Markdent is a toolkit for parsing markdown, which can also be used
to convert markdown to HTML.
• Text::Markup is a converter than can handle a number of input
formats, including markdown.
• Text::MultiMarkdown converts MultiMarkdown (a superset of the
original markdown format) to HTML.
Additional markdown resources:
• Discount <http://www.pell.portland.or.us/~orc/Code/markdown/> -
David Loren Parsons's library for converting markdown, written in
C.
• Markdown definition <http://daringfireball.net/projects/markdown/>
- John Gruber's original definition of the markdown format.
• Markdown testsuite
<http://daringfireball.net/projects/downloads/MarkdownTest_1.0.zip>
- John Gruber's testsuite for markdown.
• Markdown modules <http://neilb.org/reviews/markdown.html> - a
review of all Perl modules for handling markdown, written by Neil
Bowers.
AUTHOR
Masayoshi Sekimura, <sekimura@cpan.org>
COPYRIGHT AND LICENSE
Copyright (C) 2013 by Masayoshi Sekimura
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself, either Perl version 5.10.0 or, at
your option, any later version of Perl 5 you may have available.
This product includes software developed by David Loren Parsons
<http://www.pell.portland.or.us/~orc>
perl v5.34.0 2022-02-06 Text::Markdown::Discount(3pm)
Generated by dwww version 1.14 on Mon Feb 3 08:20:48 CET 2025.