#663 Fix section depth in markdown template (#664)

Author: adiroiban

src/towncrier/newsfragments/663.removal

@@ -0,0 +1,3 @@
+When no sections are present,
+the default Markdown template now renders the category headers as H2.
+In previous versions it was rendered as H3.

src/towncrier/templates/default.md

@@ -13,7 +13,7 @@
 
 {% if sections[section] %}
 {% for category, val in definitions.items() if category in sections[section] %}
-### {{ definitions[category]['name'] }}
+##{% if section %}#{% endif %} {{ definitions[category]['name'] }}
 
 {% for text, values in sections[section][category].items() %}
 - {{ text }}

src/towncrier/test/test_build.py

@@ -1085,7 +1085,7 @@ def test_title_format_custom_markdown(self, runner):
 
             [20-01-2001] CUSTOM RELEASE for FooBarBaz version 7.8.9
 
-            ### Features
+            ## Features
 
             - Adds levitation (#123)
 
@@ -1136,11 +1136,10 @@ def test_markdown_injected_after_header(self, runner):
         )
 
         default_template = read_pkg_resource("templates/default.md")
+        assert "##{%" in default_template
         write(
             "custom_template.md",
-            contents=default_template.replace(
-                "### {{ definitions", "#### {{ definitions"
-            ),
+            contents=default_template.replace("##{%", "####{%"),
         )
 
         result = runner.invoke(_main, ["--date", "01-01-2001"], catch_exceptions=False)
@@ -1387,7 +1386,7 @@ def test_default_start_string_markdown(self, runner):
 
             # Foo 1.2.3 (01-01-2001)
 
-            ### Features
+            ## Features
 
             - Adds levitation (#123)
 
@@ -1437,7 +1436,7 @@ def test_markdown_no_name_title(self, runner):
 
             # 1.2.3 (01-01-2001)
 
-            ### Features
+            ## Features
 
             - Adds levitation (#123)
             """
@@ -1607,7 +1606,7 @@ def test_orphans_in_non_showcontent_markdown(self, runner):
 
             # 7.8.9 (20-01-2001)
 
-            ### Misc
+            ## Misc
 
             - #123, #345
             - Another orphan misc still displayed!

src/towncrier/test/test_format.py

@@ -205,15 +205,15 @@ def test_markdown(self):
 
         expected_output = """# MyProject 1.0 (never)
 
-### Features
+## Features
 
 - Fun! (baz)
 - Foo added. (#2, #9, #72)
 - Multi-line
   here (#3)
 - Stuff! (#4)
 
-### Misc
+## Misc
 
 - bar, #1, #9, #142
 
@@ -254,7 +254,7 @@ def test_markdown(self):
         # Also test with custom issue format
         expected_output = """# MyProject 1.0 (never)
 
-### Features
+## Features
 
 - Fun! ([baz])
 - Foo added. ([2], [9], [72])
@@ -269,7 +269,7 @@ def test_markdown(self):
 [9]: https://github.com/twisted/towncrier/issues/9
 [72]: https://github.com/twisted/towncrier/issues/72
 
-### Misc
+## Misc
 
 - [bar], [1], [9], [142]