I've used asciidoc to write docs, it's got a tolerable syntax and
generates usable manpages, html, and pdf.