- Man Page

Convert Markdown syntax to (X)HTML


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

    <li>Yup, test.</li>

If no file is specified, it will expect its input from STDIN:

    $ echo "A **simple** test" | markdown
    <p>A <strong>simple</strong> test</p>



Shows the full information for this version


Shows only the version number


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

Shows this documentation


Copyright 2004 John Gruber

Copyright 2008 Tomas Doran

The manpage was written by Gunnar Wolf <> for its use in Debian systems, but can be freely used elsewhere.

For full licensing information, please refer to's full documentation.

See Also

Text::Markdown, <>


2024-01-25 perl v5.38.2 User Contributed Perl Documentation