drushdocs.php

<?php

$commands = drush_get_commands();

foreach ($commands as $name => $command) {
  $output = theme_drush_command_docs($command);
  file_put_contents("{$name}.md", $output);
}

function theme_drush_command_docs($command) {
  $output = "#{$command['command']}";


  foreach ($command['arguments'] as $arg => $desc) {
    $output .= "\n## Arguments";
    $output .= "\n* {$arg}: {$desc}";
  }

  foreach ($command['options'] as $option => $desc) {
    $output .= "\n## Options";
    $output .= "\n* {$option}: {$desc}";
  }
  return $output;
}