Overhaul Markdown documentation. Spring connector still needs rework.

supersedes and resolves #54