Documentation review

Fixed a syntax bug in the "markup" section and some misspellings.