feat: use discord expanded markdown for headers when possible

monty/constants.py

@@ -10,6 +10,7 @@
 __all__ = (
     "Client",
     "Colours",
+    "DiscordFeatures",
     "Emojis",
     "Icons",
     "Stats",
@@ -104,6 +105,12 @@ class Colours:
     gold = 0xE6C200
 
 
+class DiscordFeatures:
+    """Whether to embrace or ignore new features on Discord, in case they get rolled back."""
+
+    extended_markdown = True
+
+
 class Emojis:
     cross_mark = "\u274C"
     star = "\u2B50"

monty/utils/markdown.py

@@ -148,12 +148,23 @@ def strikethrough(self, text: str) -> str:
         """Return crossed-out text."""
         return f"~~{text}~~"
 
-    def heading(self, text: str, level: int) -> str:
-        """Format the heading to be bold if its large enough, and underline it."""
-        if level in (1, 2, 3):
-            return f"**__{text}__**\n"
-        else:
-            return f"__{text}__\n"
+    if constants.DiscordFeatures.extended_markdown:
+
+        def heading(self, text: str, level: int) -> str:
+            """Format the heading to be bold if its large enough, and underline it."""
+            if level in (1, 2, 3):
+                return "#" * (4 - level) + f" {text.strip()}\n"
+            else:
+                return f"__{text}__\n"
+
+    else:
+
+        def heading(self, text: str, level: int) -> str:
+            """Format the heading to be bold if its large enough, and underline it."""
+            if level in (1, 2, 3):
+                return f"**__{text}__**\n"
+            else:
+                return f"__{text}__\n"
 
     def newline(self) -> str:
         """No op."""