+1 for enumerating CLI options in markdown files. I commonly forget to update my READMEs when making changes to the interface and cog has been a really helpful utility to take care of this for me. I include this pattern in pretty much every tool I make nowadays, honestly probably inspired by your blog post on the topic :)
This year I also realized I could use it for my Advent of Code repository to sync my yearly progress tracker with a summary table in the base directory's README: https://github.com/sco1/adventofcode/commit/9b14483fc3d9ef58... .