Structured Text Formats

In order to write articles, books or just about any kind of documentation, DocBook and LaTeX are the obvious formats to use. Unfortunately, both are complex and difficult to learn, and the source files produced are pretty verbose and hard to read. Therefore, a number of systems offering plaintext wiki-like markup syntax have appeared. The documents written in these formats can be translated to DocBook (XML and/or SGML), LaTeX, XHTML, Unix man pages, etc.

Detail of a DocBook book coverI’m about to choose a structured text markup authoring tool from which to convert to, at least, DocBook (LaTeX also being desirable). AsciiDoc (written in Python) looks quite nice, but there are some other interesting tools such as:

  • deplate, written in Ruby
  • stx2any, a set of shell scripts based on sed and m4
  • ResT (reStructuredText), written in Python
  • parsewiki, written in Perl and included in Debian
  • aptconvert (Almost Plain Text) which is implemented in Java :-(

Have you tested any of them? How do they compare? Which one do you recommend?

51 Responses to “Structured Text Formats”

  1. I’ve been visiting your blog for a while now and I always find a gem in your new posts. Thanks for sharing.

Leave a Reply