SYNOPSIS

  $ pod2markdown < POD_File > Markdown_File
POD
<<'MKDN',
# SYNOPSIS

  $ pod2markdown < POD_File > Markdown_File
MKDN
'verbatim paragraph indents and requires no escaping';

convert_ok <<'POD', =head1 *Special* characters

html: < & <tag/> &entity;

foo_bar is the result of 4 * 4

Regular characters like *asterisks* and __underscores__ should be escaped in regular text paragraphs. Also [brackets], lists:

+ a + b

- a - b

* A line that starts with an asterisk *should* be escaped to avoid incorrectly interpreting the line as a list item.

# fake headings

### fake headings ###

Setext fake ===========

Another fake ------------

> Quote > blocks > 1. with > 2. lists

1996. A year.

* Bird

* Magic

* List item

`code` block

Hr's:

---

* * *

Inline `code`; Links: [Foo] [1], [Bar](/baz) An image:  backslash \

From http://daringfireball.net/projects/markdown/syntax:

\ backslash ` backtick * asterisk _ underscore {} curly braces [] square brackets () parentheses # hash mark + plus sign - minus sign (hyphen) . dot ! exclamation mark POD <<'MKDN', # \*Special\* characters

html: < & &lt;tag/> &amp;entity;

foo_bar is the result of 4 * 4

Regular characters like \*asterisks\* and \_\_underscores\_\_ should be escaped in regular text paragraphs. Also \[brackets\], lists:

\+ a \+ b

\- a \- b

\* A line that starts with an asterisk \*should\* be escaped to avoid incorrectly interpreting the line as a list item.

\# fake headings

\### fake headings ###

Setext fake &#x3d;==========

Another fake \------------

\> Quote \> blocks \> 1. with \> 2. lists

1996\. A year.

\* Bird

\* Magic

\* List item

`code` block

Hr's:

\---

\* \* \*

Inline \`code\`; Links: \[Foo\] \[1\], \[Bar\](/baz) An image: !\[image\](/foo) backslash \\

From http://daringfireball.net/projects/markdown/syntax:

\\ backslash \` backtick \* asterisk \_ underscore {} curly braces \[\] square brackets () parentheses \# hash mark \+ plus sign \- minus sign (hyphen) . dot ! exclamation mark MKDN 'literal markdown characters in pod escaped';

done_testing;

cpanm Pod::Markdown

perl -MCPAN -e shell
install Pod::Markdown