Add markdown reference generator (#39)

* add clap_markdown crate

* add hidden command to generate markdown reference

* replace hidden flag arg for help with hidden subcommand

Cargo.toml

@@ -16,6 +16,7 @@ categories = ["development-tools::profiling"]
 anyhow = { version = "1.0.71" }
 axum = { version = "0.6.18" }
 clap = { version = "4.2.7", features = ["derive", "env"] }
+clap-markdown = "0.1.3"
 dialoguer = "0.10.4"
 directories = { version = "5.0.1" }
 flate2 = { version = "1.0.26" }

src/bin/am/commands.rs

@@ -19,11 +19,18 @@ pub enum SubCommands {
 
     /// Manage am related system settings.
     System(system::Arguments),
+
+    #[clap(hide = true)]
+    MarkdownHelp,
 }
 
 pub async fn handle_command(app: Application) -> Result<()> {
     match app.command {
         SubCommands::Start(args) => start::handle_command(args).await,
         SubCommands::System(args) => system::handle_command(args).await,
+        SubCommands::MarkdownHelp => {
+            clap_markdown::print_help_markdown::<Application>();
+            Ok(())
+        }
     }
 }