1HTML Tidy
2=========
3
4Runs [HTML Tidy][] on the output of Python-Markdown using the [uTidylib][]
5Python wrapper. Both libtidy and uTidylib must be installed on your system.
6
7This extension is available in the standard Markdown library since version 2.0.
8
9[HTML Tidy]: http://tidy.sourceforge.net/
10[uTidylib]: http://utidylib.berlios.de/
11
12Note than any Tidy [options][] can be passed in as extension configs. So,
13for example, to output HTML rather than XHTML, set ``output_xhtml=0``. To
14indent the output, set ``indent=auto`` and to have Tidy wrap the output in
15``<html>`` and ``<body>`` tags, set ``show_body_only=0``. See Tidy's
16[options][] for a full list of the available options. The defaults are set to
17most closely match Markdowns defaults with the exception that you get much
18better pretty-printing.
19
20[options]: http://tidy.sourceforge.net/docs/quickref.html
21
22Note that options set in this extension will override most any other settings
23passed on to Markdown (such as "output_format"). Unlike Markdown, this extension
24will also treat raw HTML no different than that output by Markdown. In other
25words, it may munge a document authors carefully crafted HTML. Of course, it
26may also transform poorly formed raw HTML into nice, valid HTML. Take these
27things into consideration when electing to use this extension.
28