From 96afb073613558a984ffa29499d62a38a2806a8c Mon Sep 17 00:00:00 2001 From: Waylan Limberg Date: Thu, 6 Oct 2011 11:09:26 -0400 Subject: Added an index.md file to the docs. The docs can now be a full website unto themselves. --- docs/index.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 docs/index.md (limited to 'docs') diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..1067b72 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,61 @@ +Python-Markdown +=============== + +This is a Python implementation of John Gruber's +[Markdown](http://daringfireball.net/projects/markdown/). +It is almost completely compliant with the reference implementation, +though there are a few very minor differences. See John's +[Syntax Documentation](http://daringfireball.net/projects/markdown/syntax) +for the syntax rules. + +See the [installation instructions](install.html) to get started. + +Features +-------- + +In addition to the basic markdown syntax, Python-Markdown supports the following +features: + +* International Input + + Python-Markdown will accept input in any language supported by Unicode + including bi-directional text. In fact the test suite includes documents + written in Russian and Arabic. + +* Middle-Word Emphasis + + Python-Markdown defaults to ignoring middle-word emphasis. In other words, + `some_long_filename.txt` will not become `somelongfilename.txt`. + This can be switched off if desired. See the + [Library Reference](using_as_module.html) for details. + +* Extensions + + Various [extensions](extensions.html) are provided (including + [extra](extensions/extra.html)) to expand the base syntax. Additionally, + a public [Extension API](writing_extensions.html) is available to write + your own extensions. + +* Output Formats + + Python-Markdown can output documents in HTML4, XHTML and HTML5. + +* "Safe Mode" + + When using Python-Markdown to parse input from untrusted users on the web, + the handling of raw HTML can be controlled in various ways to prevent + harmful code from being injected into your site. + +* Command Line Interface + + In addition to being a Python Library, a + [command line script](command_line.html) is available for your convenience. + +Support +------- + +You may ask for help and discuss various other issues on the [mailing list][] +and report bugs on the [bug tracker][]. + +[mailing list]: http://lists.sourceforge.net/lists/listinfo/python-markdown-discuss +[bug tracker]: http://github.com/waylan/Python-Markdown/issues -- cgit v1.2.3