Spec syntax, line breaks, Markdown idioms

Updated spec doc to use JavaScript syntax highlighting in JSON examples, shorter lines breaks, better use of Markdown idioms.