Improve documentation.

Markdown is _much_ nicer to read. Also, I added some headings to ease the text flow.

Preview is [here](https://github.com/kotnik/localize-parser/tree/doc-fixes).