[Sphinx][] is a publishing tool that is generally used for [[Python]] documentation, although it can be used for other documents as well. Sphinx is primarily based on [reStructuredText][rst], and there are all sorts of [useful extensions][ext] (e.g. [intersphinx][], [pngmath][], ...). There is a good [tutorial][] in the [documentation][]. If you're writing a lot of Python, you should probably consider the [numpydoc][] package, which tries to [strike a balance][balance] between full markup for Sphinx publishing and raw readability. [Sphinx]: http://sphinx.pocoo.org/ [rst]: http://docutils.sf.net/rst.html [ext]: http://sphinx.pocoo.org/latest/extensions.html#builtin-sphinx-extensions [intersphinx]: http://sphinx.pocoo.org/latest/ext/intersphinx.html [pngmath]: http://sphinx.pocoo.org/latest/ext/math.html#module-sphinx.ext.pngmath [tutorial]: http://sphinx.pocoo.org/latest/tutorial.html [documentation]: http://sphinx.pocoo.org/latest/contents.html [numpydoc]: http://pypi.python.org/pypi/numpydoc/ [balance]: http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines [[!tag tags/tools]] [[!tag tags/programming]] [[!tag tags/python]]