Signed-off-by: Simon Körner <git@lubiland.de>

Converting some of the rst documentation to markdown.  Attempted to
preserve whitespace and line breaks to minimize cosmetic change.