documentation: improve readability; line length, indentation, highlighting.
Merge pull request #1036 from crate/l/docs-line-length

documentation: ensure SQL queries are below 85 chars per line.