1 files changed, 20 insertions, 0 deletions
diff --git a/doc/bugs/enumerations_of_dates_not_formatted_correctly.mdwn b/doc/bugs/enumerations_of_dates_not_formatted_correctly.mdwn
index 4a78ea3f9..f9ebf8c13 100644
--- a/doc/bugs/enumerations_of_dates_not_formatted_correctly.mdwn
+++ b/doc/bugs/enumerations_of_dates_not_formatted_correctly.mdwn
@@ -9,3 +9,23 @@ Testcase:
 * 27. March
 * 99. November
 * 42. April
+
+> That's a consequence of Markdown syntax. The syntax for ordered lists
+> (HTML `<ol>`) in Markdown is to use arbitrary numeric prefixes in that style,
+> so your text gets parsed as:
+>
+>     <ul>
+>         <li>
+>             <ol>
+>                 <li>January</li>
+>             </ol>
+>         </li>
+>         ...
+>
+> You can avoid that interpretation by escaping the dot with a backslash
+> (`1\. January`) like so:
+>
+> * 1\. January
+> * 27\. March
+>
+> or by writing "1st January" and so on. --[[smcv]]