diff --git a/external/contribute/markdown/markdown.md b/external/contribute/markdown/markdown.md
index 22841a46544acc3625b8688da4a66695ca1de645..db129fbea74d5ea9901357ed244e7473fe681812 100644
--- a/external/contribute/markdown/markdown.md
+++ b/external/contribute/markdown/markdown.md
@@ -57,7 +57,7 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
 |: ^^     + Indented item            | ^^      + Indented item
 |: ^^* Fourth item</pre>             | ^^ * Fourth item
 |:-----------------------------------|---------------------------|
-|: <pre>Include links referring to a web [page](https://www.markdownguide.org/)</pre> | Include links referring to a web [page](https://www.markdownguide.org/)
+|: Include links referring to a web `[page](https://www.markdownguide.org/)`. Avoid links in format `<link>` as it is not always parsed correctly. | Include links referring to a web [page](https://www.markdownguide.org/). Avoid links in format <link> as it is not always parsed correctly (like in this case).
 |:-----------------------------------|---------------------------|
 |: Include local pictures using markdown |
 |: ^^<pre>![My awesome picture](img/r3_logo.png)</pre> | ^^ ![My awesome picture](img/r3_logo.png)