diff --git a/docs/subsystems/markdown.md b/docs/subsystems/markdown.md
index 7f6c5f75ac..8212001c74 100644
--- a/docs/subsystems/markdown.md
+++ b/docs/subsystems/markdown.md
@@ -262,10 +262,11 @@ accurate.
 - Disable line-numbering within fenced code blocks -- the `<table>`
   output confused our web client code.
 
-### Other
+### Headings
 
-- Disable headings, both `# foo` and `== foo ==` syntax: they don't
-  make much sense for chat messages.
+- Enable headings with syntax `# foo` (syntax `== foo ==` is unsupported).
+
+### Other
 
 - Disabled images with `![]()` (images from links are shown as an inline
   preview).