Documentation completely transferred to markdown

This commit contains the rest of the documentation transferred to markdown.
I think we should use the gh_link plugin here.