markdown tools

Latest version always available at http://md-wysiwyg.sourceforge.net/. Project page http://sourceforge.net/projects/md-wysiwyg

Markdown tools is a place holder for a collection of scripts/add-ons for John Gruber's Markdown http://daringfireball.net/projects/markdown/. If you are not familar with Markdown check out http://daringfireball.net/projects/markdown/ and the intro syntax page http://daringfireball.net/projects/markdown/basics.

Markdown basically is a light weight syntax for text files that creates html and looks good as the source text. Other markup projects typically have more features but the source text tends to look "busy".

Currently all the tools on this page are Python based http://sourceforge.net/projects/python-markdown. http://markdown.infogami.com/ has links to other tools and implementations on Markdown.

Markdown wysiwyg

Demo version of markdown wysiwyg is here http://md-wysiwyg.sourceforge.net/cgi-bin/cgi_wysiwyg_test.py/

Markdown wysiwyg uses:

• widgEditor http://www.themaninblue.com/experiment/widgEditor/ - handles the editing stuff
• CherryPy version 2.1.1 (stable release) http://www.cherrypy.org/ - handles the "webby" stuff
• PythonWeb version 0.5.3 http://www.pythonweb.org/projects/webmodules
• html2text http://www.aaronsw.com/2002/html2text/ - handles the Markdown stuff

Download from http://sourceforge.net/project/showfiles.php?group_id=163219&package_id=184446 requires everything listed above bar widgEditor.

Table of Contents and title generator

An external post-processor that can be ran on the output that Markdown creates (the output could be generated with the original Perl version, Python, PHP, etc.). http://md-wysiwyg.sourceforge.net/src/markdown_postprocess.py

An extension to python-markdown http://sourceforge.net/projects/python-markdown so that a title and table of contents can be generated at the same time markdown formatting is applied. See http://www.freewisdom.org/projects/python-markdown/extensions/markdown_with_toc.py

CherryPy links:

• CherryPy itself http://www.cherrypy.org/
• Nice one page intro to CherryPy http://www-128.ibm.com/developerworks/opensource/library/os-cherrypy/?ca=dgr-lnxw01CherryPy
• CherryPy running as cgi (how to run simple CherryPy applications on Sourceforge)
  • cherrypy_cgi.py script/module to import instead of the main CherryPy module when running as cgi.
  • My original CherryPy Ticket #243, http://www.cherrypy.org/wiki/RunAsCGI. I've since updated my CherryPy as cgi script to behave more like a regular CherryPy application (in terms of calling convention, its still cgi so you still can't use it as an application server with states) and to support CHerryPy stable release 2.1.1. The demo above uses this framework.