markdown mostly

The github editor and my text editor don't get along well, so you'll want to select individual fixes.  

Plus there are a few questions embedded.
I just want the hyphens included assuming that's how it's used (if it's one, then one...)