clap2md.sh

#!/bin/bash

echo '## Operators'
"$@" help | awk '
  BEGIN {
    doprint = 0
  }
  /^\s*$/ {
    doprint = 0
  }
  {
    if (doprint) print $1
  }
  /SUBCOMMANDS/ {
    doprint = 1
  }
' | while read -r operator
do
  printf '\n### %s\n' "$operator"
  "$@" help "$operator" | awk '
    {
      switch (NR) {
        case 1: break
        case 2:
          print "\n"$0"\n"
          break
        default:
          if (length($0) > 0)
            print "    "$0
      }
    }
  '
done