This is an old revision of the document!


Markup languages for the newsletter

Featureset

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

Languages / Toolkits

LaTeX

ReST

Sphinx

AsciiDoc

Doxygen

Not sure about automatic section numbering, but it 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.

Print/export