This patch revises the markup section's introductory paragraph to read more
smoothly.

I'll be slowly working the manual!