increase use of markdown, fix lots of nits