argparser

format_help(cmd) -> help

Generate markdown-formatted help text for a command

Returns a markdown string with the following sections:

1. # <command> — name heading
2. Summary and description (when set)
3. ## Usage — generated usage line
4. ## Options — pipe table with name, default, forms, and note columns
5. ## Arguments — pipe table with name, arity, default, and note columns
6. ## Subcommands — pipe table (when present)

Inline code spans carry semantic classes for themed rendering:

• type classes: .bool, .num, .str, .file, .dir
• role classes: .opt, .arg, .flag, .meta
• state classes: .req, .def, .multi, .neg