`README.rst`: Improved readability (updated formatting)

Most changes are minor. The most noticeable are:

* Adjusted some headings (to make the document’s “big picture” outline more explicit)
* Made the distance between the introductory paragraph and the next heading as shorter (easier for newcomers to scan the page and get a sense of what the project is about)
* Made the syntax reference a table (reads significantly easier)