readme: improve markdown formatting

* Use syntax highlighting for puppet example
* Use literal tags for inline samples