Clean up the templates documentation

- Clean up a bunch of formatting
- Clarify the escaping language