diff --git a/docs/configuration.rst b/docs/configuration.rst
index e7c8a99d..e7732acb 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -80,6 +80,8 @@ Top level keys
 
     ``""`` by default.
 
+    Formatted titles are formatted with underlines on the following line (in restructured text) unless the template has an ``.md`` suffix, in which case the title will instead be prefixed with ``# `` (markdown title format).
+
 ``issue_format``
     A format string for rendering the issue/ticket number in newsfiles.