fix(Markdown): Fix rendering of deprecated properties in MD (#295)

* Fix rendering of deprecated properties in MD

A leading whitespace prevents deprecated properties to be rendered strikedthrough in Markdown. This can be avoided by positioning the whitespace as trailing in the conditionals.

* Restore fixed whitespace after batch in MD

Previously, there was a trailing whitespace after the batch. A fixed whitespace is added to restore this rendering.

* Re-add separator at required indicator in MD

* Update generated examples

---------

Co-authored-by: Denis Blanchette <[email protected]>

Author: k-rabe

docs/examples/examples_md_default/Configuration.md

@@ -26,9 +26,9 @@
     - [19.4.1. JSON Schema for Humans configuration file > template_md_options > properties_table_columns > properties_table_columns items](#template_md_options_properties_table_columns_items)
 - [20. Property `JSON Schema for Humans configuration file > with_footer`](#with_footer)
 - [21. Property `JSON Schema for Humans configuration file > footer_show_time`](#footer_show_time)
-- [22. ~~ Property `JSON Schema for Humans configuration file > allow_html_description`~~](#allow_html_description)
-- [23. ~~ Property `JSON Schema for Humans configuration file > minify`~~](#minify)
-- [24. ~~ Property `JSON Schema for Humans configuration file > templates_directory`~~](#templates_directory)
+- [22. ~~Property `JSON Schema for Humans configuration file > allow_html_description`~~](#allow_html_description)
+- [23. ~~Property `JSON Schema for Humans configuration file > minify`~~](#minify)
+- [24. ~~Property `JSON Schema for Humans configuration file > templates_directory`~~](#templates_directory)
 
 **Title:** JSON Schema for Humans configuration file
 
@@ -425,7 +425,7 @@ Must be one of:
 
 **Description:** Whether the footer should display the generation time
 
-## <a name="allow_html_description"></a>22. ~~ Property `JSON Schema for Humans configuration file > allow_html_description`~~
+## <a name="allow_html_description"></a>22. ~~Property `JSON Schema for Humans configuration file > allow_html_description`~~
 
 |                |           |
 | -------------- | --------- |
@@ -436,7 +436,7 @@ Must be one of:
 
 **Description:** [Deprecated]
 
-## <a name="minify"></a>23. ~~ Property `JSON Schema for Humans configuration file > minify`~~
+## <a name="minify"></a>23. ~~Property `JSON Schema for Humans configuration file > minify`~~
 
 |                |           |
 | -------------- | --------- |
@@ -447,7 +447,7 @@ Must be one of:
 
 **Description:** [Deprecated]
 
-## <a name="templates_directory"></a>24. ~~ Property `JSON Schema for Humans configuration file > templates_directory`~~
+## <a name="templates_directory"></a>24. ~~Property `JSON Schema for Humans configuration file > templates_directory`~~
 
 |                |          |
 | -------------- | -------- |

docs/examples/examples_md_default/deprecated.md

@@ -1,9 +1,9 @@
 # Schema Docs
 
-- [1. ~~ Property `root > deprecated1`~~](#deprecated1)
-- [2. ~~ Property `root > deprecated2`~~](#deprecated2)
-- [3. ~~ Property `root > deprecated3`~~](#deprecated3)
-- [4. ~~ Property `root > deprecated4`~~](#deprecated4)
+- [1. ~~Property `root > deprecated1`~~](#deprecated1)
+- [2. ~~Property `root > deprecated2`~~](#deprecated2)
+- [3. ~~Property `root > deprecated3`~~](#deprecated3)
+- [4. ~~Property `root > deprecated4`~~](#deprecated4)
 - [5. Property `root > not_deprecated`](#not_deprecated)
 
 |                           |                  |
@@ -22,7 +22,7 @@
 | - [deprecated4](#deprecated4 )       | No      | object | Deprecated | -          | This is [Deprecated - Use \`not_deprecated\` instead] |
 | - [not_deprecated](#not_deprecated ) | No      | string | No         | -          | -                                                     |
 
-## <a name="deprecated1"></a>1. ~~ Property `root > deprecated1`~~
+## <a name="deprecated1"></a>1. ~~Property `root > deprecated1`~~
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -33,7 +33,7 @@
 
 **Description:** [Deprecated]
 
-## <a name="deprecated2"></a>2. ~~ Property `root > deprecated2`~~
+## <a name="deprecated2"></a>2. ~~Property `root > deprecated2`~~
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -44,7 +44,7 @@
 
 **Description:** [Deprecated - Use `not_deprecated` instead]
 
-## <a name="deprecated3"></a>3. ~~ Property `root > deprecated3`~~
+## <a name="deprecated3"></a>3. ~~Property `root > deprecated3`~~
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -55,7 +55,7 @@
 
 **Description:** This is [Deprecated]
 
-## <a name="deprecated4"></a>4. ~~ Property `root > deprecated4`~~
+## <a name="deprecated4"></a>4. ~~Property `root > deprecated4`~~
 
 |                           |                  |
 | ------------------------- | ---------------- |

docs/examples/examples_md_nested_default/Configuration.md

@@ -26,9 +26,9 @@
     - [19.4.1. JSON Schema for Humans configuration file > template_md_options > properties_table_columns > properties_table_columns items](#autogenerated_heading_2)
 - [20. [Optional] Property JSON Schema for Humans configuration file > with_footer](#with_footer)
 - [21. [Optional] Property JSON Schema for Humans configuration file > footer_show_time](#footer_show_time)
-- [22. [Optional]~~ Property JSON Schema for Humans configuration file > allow_html_description~~](#allow_html_description)
-- [23. [Optional]~~ Property JSON Schema for Humans configuration file > minify~~](#minify)
-- [24. [Optional]~~ Property JSON Schema for Humans configuration file > templates_directory~~](#templates_directory)
+- [22. [Optional] ~~Property JSON Schema for Humans configuration file > allow_html_description~~](#allow_html_description)
+- [23. [Optional] ~~Property JSON Schema for Humans configuration file > minify~~](#minify)
+- [24. [Optional] ~~Property JSON Schema for Humans configuration file > templates_directory~~](#templates_directory)
 
 **Title:** JSON Schema for Humans configuration file
 
@@ -593,7 +593,7 @@ Must be one of:
 
 <details>
 <summary>
-<strong> <a name="allow_html_description"></a>22. [Optional]~~ Property JSON Schema for Humans configuration file > allow_html_description~~</strong>  
+<strong> <a name="allow_html_description"></a>22. [Optional] ~~Property JSON Schema for Humans configuration file > allow_html_description~~</strong>  
 
 </summary>
 <blockquote>
@@ -612,7 +612,7 @@ Must be one of:
 
 <details>
 <summary>
-<strong> <a name="minify"></a>23. [Optional]~~ Property JSON Schema for Humans configuration file > minify~~</strong>  
+<strong> <a name="minify"></a>23. [Optional] ~~Property JSON Schema for Humans configuration file > minify~~</strong>  
 
 </summary>
 <blockquote>
@@ -631,7 +631,7 @@ Must be one of:
 
 <details>
 <summary>
-<strong> <a name="templates_directory"></a>24. [Optional]~~ Property JSON Schema for Humans configuration file > templates_directory~~</strong>  
+<strong> <a name="templates_directory"></a>24. [Optional] ~~Property JSON Schema for Humans configuration file > templates_directory~~</strong>  
 
 </summary>
 <blockquote>

docs/examples/examples_md_nested_default/deprecated.md

@@ -1,9 +1,9 @@
 # Schema Docs
 
-- [1. [Optional]~~ Property root > deprecated1~~](#deprecated1)
-- [2. [Optional]~~ Property root > deprecated2~~](#deprecated2)
-- [3. [Optional]~~ Property root > deprecated3~~](#deprecated3)
-- [4. [Optional]~~ Property root > deprecated4~~](#deprecated4)
+- [1. [Optional] ~~Property root > deprecated1~~](#deprecated1)
+- [2. [Optional] ~~Property root > deprecated2~~](#deprecated2)
+- [3. [Optional] ~~Property root > deprecated3~~](#deprecated3)
+- [4. [Optional] ~~Property root > deprecated4~~](#deprecated4)
 - [5. [Optional] Property root > not_deprecated](#not_deprecated)
 
 |                           |                  |
@@ -16,7 +16,7 @@
 
 <details>
 <summary>
-<strong> <a name="deprecated1"></a>1. [Optional]~~ Property root > deprecated1~~</strong>  
+<strong> <a name="deprecated1"></a>1. [Optional] ~~Property root > deprecated1~~</strong>  
 
 </summary>
 <blockquote>
@@ -35,7 +35,7 @@
 
 <details>
 <summary>
-<strong> <a name="deprecated2"></a>2. [Optional]~~ Property root > deprecated2~~</strong>  
+<strong> <a name="deprecated2"></a>2. [Optional] ~~Property root > deprecated2~~</strong>  
 
 </summary>
 <blockquote>
@@ -54,7 +54,7 @@
 
 <details>
 <summary>
-<strong> <a name="deprecated3"></a>3. [Optional]~~ Property root > deprecated3~~</strong>  
+<strong> <a name="deprecated3"></a>3. [Optional] ~~Property root > deprecated3~~</strong>  
 
 </summary>
 <blockquote>
@@ -73,7 +73,7 @@
 
 <details>
 <summary>
-<strong> <a name="deprecated4"></a>4. [Optional]~~ Property root > deprecated4~~</strong>  
+<strong> <a name="deprecated4"></a>4. [Optional] ~~Property root > deprecated4~~</strong>  
 
 </summary>
 <blockquote>

docs/examples/examples_md_nested_default/pattern_properties.md

@@ -2,7 +2,7 @@
 
 - [1. [Optional] Property Person > firstName](#firstName)
 - [2. [Optional] Property Person > lastName](#lastName)
-- [3. [Optional]Pattern Property Person > paperSize](#pattern1)
+- [3. [Optional] Pattern Property Person > paperSize](#pattern1)
   - [3.1. [Required] Property Person > paperSize > rating](#pattern1_rating)
   - [3.2. [Required] Property Person > paperSize > review](#pattern1_review)
 
@@ -54,7 +54,7 @@
 
 <details>
 <summary>
-<strong> <a name="pattern1"></a>3. [Optional]Pattern Property Person > paperSize</strong>  
+<strong> <a name="pattern1"></a>3. [Optional] Pattern Property Person > paperSize</strong>  
 > All properties whose name matches the regular expression
 ```$[a-c][0-9]^``` ([Test](https://regex101.com/?regex=%24%5Ba-c%5D%5B0-9%5D%5E))
 must respect the following conditions

docs/examples/examples_md_nested_default/pattern_properties_html_id.md

@@ -1,10 +1,10 @@
 # Person
 
 - [1. [Optional] Property Person > not_a_pattern](#not_a_pattern)
-  - [1.1. [Optional]Pattern Property Person > not_a_pattern > Title 4](#not_a_pattern_pattern1)
-- [2. [Optional]Pattern Property Person > Title 1](#pattern1)
-- [3. [Optional]Pattern Property Person > Title 2](#pattern2)
-- [4. [Optional]Pattern Property Person > Title 3](#pattern3)
+  - [1.1. [Optional] Pattern Property Person > not_a_pattern > Title 4](#not_a_pattern_pattern1)
+- [2. [Optional] Pattern Property Person > Title 1](#pattern1)
+- [3. [Optional] Pattern Property Person > Title 2](#pattern2)
+- [4. [Optional] Pattern Property Person > Title 3](#pattern3)
 
 **Title:** Person
 
@@ -29,7 +29,7 @@
 
 <details>
 <summary>
-<strong> <a name="not_a_pattern_pattern1"></a>1.1. [Optional]Pattern Property Person > not_a_pattern > Title 4</strong>  
+<strong> <a name="not_a_pattern_pattern1"></a>1.1. [Optional] Pattern Property Person > not_a_pattern > Title 4</strong>  
 > All properties whose name matches the regular expression
 ```.$``` ([Test](https://regex101.com/?regex=.%24))
 must respect the following conditions
@@ -55,7 +55,7 @@ must respect the following conditions
 
 <details>
 <summary>
-<strong> <a name="pattern1"></a>2. [Optional]Pattern Property Person > Title 1</strong>  
+<strong> <a name="pattern1"></a>2. [Optional] Pattern Property Person > Title 1</strong>  
 > All properties whose name matches the regular expression
 ```.*``` ([Test](https://regex101.com/?regex=.%2A))
 must respect the following conditions
@@ -78,7 +78,7 @@ must respect the following conditions
 
 <details>
 <summary>
-<strong> <a name="pattern2"></a>3. [Optional]Pattern Property Person > Title 2</strong>  
+<strong> <a name="pattern2"></a>3. [Optional] Pattern Property Person > Title 2</strong>  
 > All properties whose name matches the regular expression
 ```..``` ([Test](https://regex101.com/?regex=..))
 must respect the following conditions
@@ -101,7 +101,7 @@ must respect the following conditions
 
 <details>
 <summary>
-<strong> <a name="pattern3"></a>4. [Optional]Pattern Property Person > Title 3</strong>  
+<strong> <a name="pattern3"></a>4. [Optional] Pattern Property Person > Title 3</strong>  
 > All properties whose name matches the regular expression
 ```^.``` ([Test](https://regex101.com/?regex=%5E.))
 must respect the following conditions

docs/examples/examples_md_nested_with_badges/Configuration.md

@@ -26,9 +26,9 @@
     - [19.4.1. JSON Schema for Humans configuration file > template_md_options > properties_table_columns > properties_table_columns items](#autogenerated_heading_2)
 - [20. [Optional] Property JSON Schema for Humans configuration file > with_footer](#with_footer)
 - [21. [Optional] Property JSON Schema for Humans configuration file > footer_show_time](#footer_show_time)
-- [22. [Optional]~~ Property JSON Schema for Humans configuration file > allow_html_description~~](#allow_html_description)
-- [23. [Optional]~~ Property JSON Schema for Humans configuration file > minify~~](#minify)
-- [24. [Optional]~~ Property JSON Schema for Humans configuration file > templates_directory~~](#templates_directory)
+- [22. [Optional] ~~Property JSON Schema for Humans configuration file > allow_html_description~~](#allow_html_description)
+- [23. [Optional] ~~Property JSON Schema for Humans configuration file > minify~~](#minify)
+- [24. [Optional] ~~Property JSON Schema for Humans configuration file > templates_directory~~](#templates_directory)
 
 **Title:** JSON Schema for Humans configuration file
 
@@ -566,7 +566,7 @@ Must be one of:
 
 <details>
 <summary>
-<strong> <a name="allow_html_description"></a>22. [Optional]~~ Property JSON Schema for Humans configuration file > allow_html_description~~</strong>  
+<strong> <a name="allow_html_description"></a>22. [Optional] ~~Property JSON Schema for Humans configuration file > allow_html_description~~</strong>  
 
 </summary>
 <blockquote>
@@ -585,7 +585,7 @@ Must be one of:
 
 <details>
 <summary>
-<strong> <a name="minify"></a>23. [Optional]~~ Property JSON Schema for Humans configuration file > minify~~</strong>  
+<strong> <a name="minify"></a>23. [Optional] ~~Property JSON Schema for Humans configuration file > minify~~</strong>  
 
 </summary>
 <blockquote>
@@ -604,7 +604,7 @@ Must be one of:
 
 <details>
 <summary>
-<strong> <a name="templates_directory"></a>24. [Optional]~~ Property JSON Schema for Humans configuration file > templates_directory~~</strong>  
+<strong> <a name="templates_directory"></a>24. [Optional] ~~Property JSON Schema for Humans configuration file > templates_directory~~</strong>  
 
 </summary>
 <blockquote>

docs/examples/examples_md_nested_with_badges/deprecated.md

@@ -1,9 +1,9 @@
 # Schema Docs
 
-- [1. [Optional]~~ Property root > deprecated1~~](#deprecated1)
-- [2. [Optional]~~ Property root > deprecated2~~](#deprecated2)
-- [3. [Optional]~~ Property root > deprecated3~~](#deprecated3)
-- [4. [Optional]~~ Property root > deprecated4~~](#deprecated4)
+- [1. [Optional] ~~Property root > deprecated1~~](#deprecated1)
+- [2. [Optional] ~~Property root > deprecated2~~](#deprecated2)
+- [3. [Optional] ~~Property root > deprecated3~~](#deprecated3)
+- [4. [Optional] ~~Property root > deprecated4~~](#deprecated4)
 - [5. [Optional] Property root > not_deprecated](#not_deprecated)
 
 |                           |                                                                             |
@@ -15,7 +15,7 @@
 
 <details>
 <summary>
-<strong> <a name="deprecated1"></a>1. [Optional]~~ Property root > deprecated1~~</strong>  
+<strong> <a name="deprecated1"></a>1. [Optional] ~~Property root > deprecated1~~</strong>  
 
 </summary>
 <blockquote>
@@ -34,7 +34,7 @@
 
 <details>
 <summary>
-<strong> <a name="deprecated2"></a>2. [Optional]~~ Property root > deprecated2~~</strong>  
+<strong> <a name="deprecated2"></a>2. [Optional] ~~Property root > deprecated2~~</strong>  
 
 </summary>
 <blockquote>
@@ -53,7 +53,7 @@
 
 <details>
 <summary>
-<strong> <a name="deprecated3"></a>3. [Optional]~~ Property root > deprecated3~~</strong>  
+<strong> <a name="deprecated3"></a>3. [Optional] ~~Property root > deprecated3~~</strong>  
 
 </summary>
 <blockquote>
@@ -72,7 +72,7 @@
 
 <details>
 <summary>
-<strong> <a name="deprecated4"></a>4. [Optional]~~ Property root > deprecated4~~</strong>  
+<strong> <a name="deprecated4"></a>4. [Optional] ~~Property root > deprecated4~~</strong>  
 
 </summary>
 <blockquote>

docs/examples/examples_md_nested_with_badges/pattern_properties.md

@@ -2,7 +2,7 @@
 
 - [1. [Optional] Property Person > firstName](#firstName)
 - [2. [Optional] Property Person > lastName](#lastName)
-- [3. [Optional]Pattern Property Person > paperSize](#pattern1)
+- [3. [Optional] Pattern Property Person > paperSize](#pattern1)
   - [3.1. [Required] Property Person > paperSize > rating](#pattern1_rating)
   - [3.2. [Required] Property Person > paperSize > review](#pattern1_review)
 
@@ -51,7 +51,7 @@
 
 <details>
 <summary>
-<strong> <a name="pattern1"></a>3. [Optional]Pattern Property Person > paperSize</strong>  
+<strong> <a name="pattern1"></a>3. [Optional] Pattern Property Person > paperSize</strong>  
 > All properties whose name matches the regular expression
 ```$[a-c][0-9]^``` ([Test](https://regex101.com/?regex=%24%5Ba-c%5D%5B0-9%5D%5E))
 must respect the following conditions