Auto-generate markdown command docs (#4451)

* Finish updating

* a couple improvements

* Update renames

* cleanup examples

docs/commands/mkdir.md

@@ -1,21 +1,17 @@
-# mkdir
+---
+title: mkdir
+layout: command
+version: 0.59.0
+---
+
 Make directories, creates intermediary directories as required.
 
-## Usage
-```shell
-> mkdir ...args {flags} 
- ```
+## Signature
+
+```> mkdir ...rest --show-created-paths```
 
 ## Parameters
-* ...args: the name(s) of the path(s) to create
 
-## Flags
-* -h, --help: Display this help message
-* -s, --show-created-paths: show the path(s) created.
-
-## Examples
-  Make a directory named foo
-```shell
-> mkdir foo
- ```
+ -  `...rest`: the name(s) of the path(s) to create
+ -  `--show-created-paths`: show the path(s) created.