From e58111469bae56d92579082ef9e29e7f1d08cf97 Mon Sep 17 00:00:00 2001 From: Waylan Limberg Date: Thu, 6 Oct 2011 10:28:25 -0400 Subject: Updated docs/extensions/index to be more informative - not just list extensions. --- docs/extensions/index.md | 32 ++++++++++++++++++++++++++++++-- 1 file changed, 30 insertions(+), 2 deletions(-) (limited to 'docs/extensions') diff --git a/docs/extensions/index.md b/docs/extensions/index.md index 5578cbb..7ab2414 100644 --- a/docs/extensions/index.md +++ b/docs/extensions/index.md @@ -1,11 +1,27 @@ Available Extensions ==================== +Python Markdown offers a flexible extension mechanism, which makes it possible +to change and/or extend the behavior of the parser without having to edit the +actual source files. + +To use an extension, pass it's name to markdown with the `extensions` keyword. +See [Using Markdown as a Python Library](../using_as_module.html) for more +details. + + markdown.markdown(some_text, extensions=['extra', 'nl2br']) + +From the command line, specify an extension with the `-x` option. +See [Using Python-Markdown on the Command Line](../command_line.html) or use the +`--help` option for more details. + + python -m markdown -x extra input.txt > output.html + Officially Supported Extensions ------------------------------- -These extensions are included with (at least) the most recent release and are -officially supported by the Python-Markdown developers. Any documentation is +The extensions lists below are included with (at least) the most recent release +and are officially supported by Python-Markdown. Any documentation is maintained here and all bug reports should be made to the project. If you have a typical install of Python-Markdown, these extensions are already available to you. @@ -27,3 +43,15 @@ available to you. * [Table of Contents](toc.html) * [WikiLinks](wikilinks.html) +Third Party Extensions +---------------------- + +Various individuals and/or organizations have developed extensions which they +have made available to the public. A [list of third party +extensions](http://freewisdom.org/projects/python-markdown/Available_Extensions) +is maintained on the wiki for your convenience. The Python-Markdown team +offers no official support for these extensions. Please see the developer of +each extension for support. + +If you would like to write your own extensions, see the +[Extensions API](../writing_extensions.html) for details. -- cgit v1.2.3