SysTutorials

Linux Manual Pages › Section 1

markdown-pl(1)

Markdown.pl - Convert Markdown syntax to (X)HTML

Description

This program is distributed as part of Perl's Text::Markdown module, illustrating sample usage.

Markdown can be invoked on any file containing Markdown-syntax, and will produce the corresponding (X)HTML on STDOUT:

 $ cat file.txt
 This is a *test*.
 Absolutely _nothing_ to see here. _Just a **test**_!
 * test
 * Yup, test.
 $ Markdown.pl file.txt
 <p>This is a <em>test</em>.</p>
 <p>Absolutely <em>nothing</em> to see here. <em>Just a <strong>test</strong></em>!</p>
 <ul>
 <li>test</li>
 <li>Yup, test.</li>
 </ul>
If no file is specified, it will expect its input from STDIN:
 $ echo "A **simple** test" | markdown
 <p>A <strong>simple</strong> test</p>

Options

version
Shows the full information for this version
shortversion
Shows only the version number
html4tags
Produce HTML 4-style tags instead of XHTML - XHTML requires elements that do not wrap a block (i.e. the "hr" tag) to state they will not be closed, by closing with "/>". HTML 4-style will plainly output the tag as it comes:
 $ echo '---' | markdown
 <hr />
 $ echo '---' | markdown --html4tags
 <hr>
help
Shows this documentation

Author

Copyright 2004 John Gruber

Copyright 2008 Tomas Doran

The manpage was written by Gunnar Wolf <gwolf [at] debian.org> for its use in Debian systems, but can be freely used elsewhere.

For full licensing information, please refer to Text::Markdown.pm’s full documentation.

See Also

Text::Markdown, <http://daringfireball.net/projects/markdown/>