GenerateDoccReference: group arguments by section like CLI help

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorDoccReference().md

@@ -6,6 +6,8 @@
 color --fav=<fav> [--second=<second>] [--help]
 ```
 
+## Options
+
 - term **--fav=\<fav\>**:
 
 *Your favorite color.*
@@ -31,6 +33,8 @@ Show subcommand help information.
 color help [<subcommands>...]
 ```
 
+### Arguments
+
 - term **subcommands**:
 
 

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testColorMarkdownReference().md

@@ -6,6 +6,8 @@
 color --fav=<fav> [--second=<second>] [--help]
 ```
 
+## Options
+
 **--fav=\<fav\>:**
 
 *Your favorite color.*
@@ -31,6 +33,8 @@ Show subcommand help information.
 color help [<subcommands>...]
 ```
 
+### Arguments
+
 **subcommands:**
 
 

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testCountLinesDoccReference().md

@@ -7,11 +7,15 @@ count-lines [<input-file>] [--prefix=<prefix>] [--verbose]
   [--help]
 ```
 
+## Arguments
+
 - term **input-file**:
 
 *A file to count lines in. If omitted, counts the lines of stdin.*
 
 
+## Options
+
 - term **--prefix=\<prefix\>**:
 
 *Only count lines with this prefix.*
@@ -35,8 +39,9 @@ Show subcommand help information.
 count-lines help [<subcommands>...]
 ```
 
-- term **subcommands**:
+### Arguments
 
+- term **subcommands**:
 
 
 

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testCountLinesMarkdownReference().md

@@ -6,11 +6,15 @@
 count-lines [<input-file>] [--prefix=<prefix>] [--verbose] [--help]
 ```
 
+## Arguments
+
 **input-file:**
 
 *A file to count lines in. If omitted, counts the lines of stdin.*
 
 
+## Options
+
 **--prefix=\<prefix\>:**
 
 *Only count lines with this prefix.*
@@ -34,8 +38,9 @@ Show subcommand help information.
 count-lines help [<subcommands>...]
 ```
 
-**subcommands:**
+### Arguments
 
+**subcommands:**
 
 
 

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testMathDoccReference().md

@@ -8,6 +8,8 @@ A utility for performing maths.
 math [--version] [--help]
 ```
 
+## Options
+
 - term **--version**:
 
 *Show the version.*
@@ -26,16 +28,20 @@ Print the sum of the values.
 math add [--hex-output] [<values>...] [--version] [--help]
 ```
 
-- term **--hex-output**:
-
-*Use hexadecimal notation for the result.*
-
+### Arguments
 
 - term **values**:
 
 *A group of integers to operate on.*
 
 
+### Options
+
+- term **--hex-output**:
+
+*Use hexadecimal notation for the result.*
+
+
 - term **--version**:
 
 *Show the version.*
@@ -57,16 +63,20 @@ math multiply [--hex-output] [<values>...] [--version]
   [--help]
 ```
 
-- term **--hex-output**:
-
-*Use hexadecimal notation for the result.*
-
+### Arguments
 
 - term **values**:
 
 *A group of integers to operate on.*
 
 
+### Options
+
+- term **--hex-output**:
+
+*Use hexadecimal notation for the result.*
+
+
 - term **--version**:
 
 *Show the version.*
@@ -87,6 +97,8 @@ Calculate descriptive statistics.
 math stats [--version] [--help]
 ```
 
+### Options
+
 - term **--version**:
 
 *Show the version.*
@@ -106,16 +118,20 @@ math stats average [--kind=<kind>] [<values>...] [--version]
   [--help]
 ```
 
-- term **--kind=\<kind\>**:
-
-*The kind of average to provide.*
-
+#### Arguments
 
 - term **values**:
 
 *A group of floating-point values to operate on.*
 
 
+#### Options
+
+- term **--kind=\<kind\>**:
+
+*The kind of average to provide.*
+
+
 - term **--version**:
 
 *Show the version.*
@@ -136,11 +152,15 @@ Print the standard deviation of the values.
 math stats stdev [<values>...] [--version] [--help]
 ```
 
+#### Arguments
+
 - term **values**:
 
 *A group of floating-point values to operate on.*
 
 
+#### Options
+
 - term **--version**:
 
 *Show the version.*
@@ -166,6 +186,8 @@ math stats quantiles [<one-of-four>] [<custom-arg>]
   [--help]
 ```
 
+#### Arguments
+
 - term **one-of-four**:
 
 
@@ -180,6 +202,8 @@ math stats quantiles [<one-of-four>] [<custom-arg>]
 *A group of floating-point values to operate on.*
 
 
+#### Options
+
 - term **--file=\<file\>**:
 
 
@@ -217,9 +241,13 @@ Show subcommand help information.
 math help [<subcommands>...] [--version]
 ```
 
+### Arguments
+
 - term **subcommands**:
 
 
+### Options
+
 - term **--version**:
 
 *Show the version.*

Tests/ArgumentParserGenerateDoccReferenceTests/Snapshots/testMathMarkdownReference().md

@@ -8,6 +8,8 @@ A utility for performing maths.
 math [--version] [--help]
 ```
 
+## Options
+
 **--version:**
 
 *Show the version.*
@@ -26,16 +28,20 @@ Print the sum of the values.
 math add [--hex-output] [<values>...] [--version] [--help]
 ```
 
-**--hex-output:**
-
-*Use hexadecimal notation for the result.*
-
+### Arguments
 
 **values:**
 
 *A group of integers to operate on.*
 
 
+### Options
+
+**--hex-output:**
+
+*Use hexadecimal notation for the result.*
+
+
 **--version:**
 
 *Show the version.*
@@ -56,16 +62,20 @@ Print the product of the values.
 math multiply [--hex-output] [<values>...] [--version] [--help]
 ```
 
-**--hex-output:**
-
-*Use hexadecimal notation for the result.*
-
+### Arguments
 
 **values:**
 
 *A group of integers to operate on.*
 
 
+### Options
+
+**--hex-output:**
+
+*Use hexadecimal notation for the result.*
+
+
 **--version:**
 
 *Show the version.*
@@ -86,6 +96,8 @@ Calculate descriptive statistics.
 math stats [--version] [--help]
 ```
 
+### Options
+
 **--version:**
 
 *Show the version.*
@@ -104,16 +116,20 @@ Print the average of the values.
 math stats average [--kind=<kind>] [<values>...] [--version] [--help]
 ```
 
-**--kind=\<kind\>:**
-
-*The kind of average to provide.*
-
+#### Arguments
 
 **values:**
 
 *A group of floating-point values to operate on.*
 
 
+#### Options
+
+**--kind=\<kind\>:**
+
+*The kind of average to provide.*
+
+
 **--version:**
 
 *Show the version.*
@@ -134,11 +150,15 @@ Print the standard deviation of the values.
 math stats stdev [<values>...] [--version] [--help]
 ```
 
+#### Arguments
+
 **values:**
 
 *A group of floating-point values to operate on.*
 
 
+#### Options
+
 **--version:**
 
 *Show the version.*
@@ -162,6 +182,8 @@ math stats quantiles [<one-of-four>] [<custom-arg>] [<custom-deprecated-arg>]
   [--help]
 ```
 
+#### Arguments
+
 **one-of-four:**
 
 
@@ -176,6 +198,8 @@ math stats quantiles [<one-of-four>] [<custom-arg>] [<custom-deprecated-arg>]
 *A group of floating-point values to operate on.*
 
 
+#### Options
+
 **--file=\<file\>:**
 
 
@@ -213,9 +237,13 @@ Show subcommand help information.
 math help [<subcommands>...] [--version]
 ```
 
+### Arguments
+
 **subcommands:**
 
 
+### Options
+
 **--version:**
 
 *Show the version.*