From 4aa74abe0835b2430e51dc628c10f2e04b9b894b Mon Sep 17 00:00:00 2001
From: albert-github <albert.tests@gmail.com>
Date: Sun, 18 Oct 2020 19:07:51 +0200
Subject: Incomplete  documentation in respect to hyphens for horizontal rulers

In case of a sequence of hyphens the documentation was incomplete.
(found during implementation of "Miscounting in markdown in case of a horizontal ruler", #8115)
---
 doc/markdown.doc | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/markdown.doc b/doc/markdown.doc
index 883e831..eba9431 100644
--- a/doc/markdown.doc
+++ b/doc/markdown.doc
@@ -155,7 +155,10 @@ Examples:
     ______
 
 Note that using asterisks in comment blocks does not work. See 
-\ref mddox_stars for details.
+\ref mddox_stars for details.<br>
+Note that when using hyphens and the previous line is not empty you have to
+use at least one whitespace in the sequence of hyphens otherwise it might be
+seen as a level 2 header (see \ref md_headers).
 
 \subsection md_emphasis Emphasis
 
-- 
cgit v0.12

