You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

28 lines
1.3 KiB

HTML Tidy
=========
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.
[HTML Tidy]: http://tidy.sourceforge.net/
[uTidylib]: http://utidylib.berlios.de/
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.
[options]: http://tidy.sourceforge.net/docs/quickref.html
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.