NAME Markdown::To::POD - Convert Markdown syntax to POD VERSION This document describes version 0.02 of Markdown::To::POD (from Perl distribution Markdown-To-POD), released on 2014-07-21. SYNOPSIS use Markdown::To::POD 'markdown_to_pod'; my $pod = markdown_to_pod($text); DESCRIPTION Markdown::To::POD notes: Markdown::To::POD is a markdown-to-POD converter. Currently it's implemented as a quick-and-dirty hack of forking Text::Markdown 1.000031 then modifying just enough to produce POD instead of HTML. I hacked it because I want an alternative to Markdown::Pod 0.005 which is too startup-heavy and has a couple of annoying bugs, like converting "an_identifier and another_identifier" to "anidentifier". The rest of the documentation is Text::Markdown's. Markdown is a text-to-HTML filter; it translates an easy-to-read / easy-to-write structured text format into HTML. Markdown's text format is most similar to that of plain text email, and supports features such as headers, *emphasis*, code blocks, blockquotes, and links. Markdown's syntax is designed not as a generic markup language, but specifically to serve as a front-end to (X)HTML. You can use span-level HTML tags anywhere in a Markdown document, and you can use block level HTML tags (like
and as well). SYNTAX This module implements the 'original' Markdown markdown syntax from: http://daringfireball.net/projects/markdown/ Note that Text::Markdown ensures that the output always ends with one newline. The fact that multiple newlines are collapsed into one makes sense, because this is the behavior of HTML towards whispace. The fact that there's always a newline at the end makes sense again, given that the output will always be nested in a block-level element (as opposed to an inline element). That block element can be a "

" (most often), or a "

". Markdown is not interpreted in HTML block-level elements, in order for chunks of pasted HTML (e.g. JavaScript widgets, web counters) to not be magically (mis)interpreted. For selective processing of Markdown in some, but not other, HTML block elements, add a "markdown" attribute to the block element and set its value to 1, "on" or "yes":