While not an issue, you may be interested in using something like sphinxcontrib-programoutput to have your CLI help command generated upon each commit so that it always stays up to date.
The one rub would be that you'd need to switch from markdown to rst, but that should be easy using panda. If you're interested and run into any trouble, I'm happy to help out.