convert plain text docs to markdown

This initial commit attempts to match the formatting of the PDF version
as closely as possible.  There may be some additional formatting needed
or perhaps headings added to make up for the lost of color highlighting,
but those are not included here.