From c2dc73cfed35357a637d67dfa64885afeada9f20 Mon Sep 17 00:00:00 2001
From: malteneuss <malteneuss@users.noreply.github.com>
Date: Wed, 15 Dec 2021 07:56:55 +0100
Subject: Add hint about inline link issue (#1444)

---
 doc/markup.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

(limited to 'doc/markup.rst')

diff --git a/doc/markup.rst b/doc/markup.rst
index c0b08a40..3d5bf12a 100644
--- a/doc/markup.rst
+++ b/doc/markup.rst
@@ -1121,6 +1121,17 @@ followed by the URL enclosed in regular parentheses, for example: ::
 The link text is used as a description for the URL if the output
 format supports it.
 
+Hint: There's a `known issue <https://github.com/haskell/haddock/issues/774>`_ 
+that any inline link at the beginning of a line within a multi-line comment 
+isn't rendered correctly: ::
+   
+    {-| Some multi-line comment that has a
+    [link](https://example.com) and a
+    [reference link]: https://example.com
+    -}
+    
+Adding a space or a word in front of such a link can be used as a workaround.   
+   
 Images
 ~~~~~~
 
-- 
cgit v1.2.3