Move to markdown

please do not merge yet, this is a work in progress, and the PR is to simplify external review.