refactor: Give precedence to Markdown heading level (##)

pawamoy · pawamoy · commit 2e5f89e8cef1 · 2024-07-25T12:43:43.000+02:00
diff --git a/src/mkdocstrings/extension.py b/src/mkdocstrings/extension.py
@@ -208,7 +208,8 @@ def _process_block(
         options = ChainMap(local_options, global_options)
 
         if heading_level:
-            options = ChainMap(options, {"heading_level": heading_level})  # like setdefault
+            # Heading level obtained from Markdown (`##`) takes precedence.
+            options = ChainMap({"heading_level": heading_level}, options)
 
         log.debug("Collecting data")
         try:
