Asciidoc generation for CLI reference documentation

[jvanz]

This is a spin off #493. We should follow the discussions in the ConnorGray/clap-markdown#40 considering an upstream contribution or write a conversion script to automatically generate Asciidoc documentation for the CLI reference documentation.

Acceptance criteria

• Upstream contribution in the clap-markdown crate to generate Asciidoc documentation or write a script to do the conversion from markdown to asciidoc.

[jvanz]

cc @jhkrug