Don't get me wrong, cljfmt is great, but every time I come back to it, I end up scratching my head when reading over how indentation rules work in the README. I expect I am not the only one who gets confused?

1. I find the concept of :inner and :block straightforward but it often takes me a while to figure out what their arguments actually mean. So a little more hand-holding there would be nice.
2. go over the formatted code examples and verify they match today's reality.
3. try to make the section more clear in general, this might involve a bit of re-ordering of examples.
4. I understand you appreciate succinctness and will do my best to comply.

I will, unless you have strong objections, follow up with a PR for review.