diff options
| author | Waylan Limberg <waylan@gmail.com> | 2011-08-23 10:53:49 -0400 |
|---|---|---|
| committer | Waylan Limberg <waylan@gmail.com> | 2011-08-23 10:53:49 -0400 |
| commit | a6fd7b5cba69cad049046b3a372d0f2d6c495abe (patch) | |
| tree | 42a8987d08eb5a05eb2b3cb1399540583e8cbf67 /docs/extensions/html_tidy.md | |
| parent | e5b2813bbf02710c7deb148896085a3dac4828dc (diff) | |
| download | markdown-a6fd7b5cba69cad049046b3a372d0f2d6c495abe.tar.gz markdown-a6fd7b5cba69cad049046b3a372d0f2d6c495abe.tar.bz2 markdown-a6fd7b5cba69cad049046b3a372d0f2d6c495abe.zip | |
Renamed *.txt -> *.md in docs.
Diffstat (limited to 'docs/extensions/html_tidy.md')
| -rw-r--r-- | docs/extensions/html_tidy.md | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/docs/extensions/html_tidy.md b/docs/extensions/html_tidy.md new file mode 100644 index 0000000..52f991f --- /dev/null +++ b/docs/extensions/html_tidy.md @@ -0,0 +1,27 @@ +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. |