Corrected typos in docs. Clarified a few points.
Now using more obscure delimiters for JSON blocks. Fixes #271.