clap's approach with special modules works pretty nicely. It ties documentation to rustdoc by using some special modules like _config, _storages, etc, and can be written in plain markdown.