Markup languages for the newsletter

• Table of contents
• Automatic section numbering
• Output in HTML, plain text, PDF

Not sure about automatic section numbering, but Doxygen does all the other stuff and is already being used in Geany (see the Plugin Howto). It can be used like this to generate documents, even though it's normally used with source code API docs (I guess it's the same case as Sphinx and GTK-DOC?). Pros are it's easy, matches existing Geany documents, and supports lots of output formats. Cons are that it's not the primary use for the tool and it might not do plain text output, and the markup seems not to be great for plain-text use.

As mentioned in the mailing list Pandoc is quite suitable for the newsletter and it supports Markdown which is quite nice.