Runs HTML Tidy on the output of Python-Markdown using the uTidylib Python wrapper. Both libtidy and uTidylib must be installed on your system.
This extension is available in the standard Markdown library since version 2.0.
Note than any Tidy options can be passed in as extension configs. So,
for example, to output HTML rather than XHTML, set output_xhtml=0
. To
indent the output, set indent=auto
and to have Tidy wrap the output in
<html>
and <body>
tags, set show_body_only=0
. See Tidy's
options for a full list of the available options. The defaults are set to
most closely match Markdowns defaults with the exception that you get much
better pretty-printing.
Note that options set in this extension will override most any other settings passed on to Markdown (such as "output_format"). Unlike Markdown, this extension will also treat raw HTML no different than that output by Markdown. In other words, it may munge a document authors carefully crafted HTML. Of course, it may also transform poorly formed raw HTML into nice, valid HTML. Take these things into consideration when electing to use this extension.