Syntax update for README

Also fix a few typos, correct one filename, re-add section links,
replace two instances of misleading pathseps (`/` in Windows example).