Add --help output to README and docs?

It was suggested on HN that the --help output be included in the README and to the docs to aid in discoverability:

https://news.ycombinator.com/item?id=45177690

Putting it in the docs is fine, I'll do that. But I'm torn about putting it in the README. I'm worried that would make the README too busy.