diff --git a/docs/markdownrules.md b/docs/markdownrules.md
index ca7f1986b951667bc512392a64236d4727009427..50325a938521982e04bf0927bc9620b4d0d3c09c 100644
--- a/docs/markdownrules.md
+++ b/docs/markdownrules.md
@@ -13,8 +13,8 @@ language is useful for:
 [GitHub]: https://github.com
 
 Markdown language is mostly consistent across these platforms, but some
-discrepancies do exist. The `mkdocs` specific guide for markdown, as used in 
-this book is 
+discrepancies do exist. The `mkdocs` specific guide for markdown, as used in
+this book is
 [here](http://www.mkdocs.org/user-guide/writing-your-docs).
 
 
@@ -36,12 +36,12 @@ platforms.
 
         Try [CiviCRM](https://civicrm.org) for your database.
 
--   An internal hyperlink on mkdocs (4 different ways that all work)
+-   An internal hyperlink on mkdocs. The `.md` is optional.
+    *Make sure to use an absolute path and precede the path with a slash,
+    as shown below.*
 
         [extensions](/extensions/basics)
         [extensions](/extensions/basics.md)
-        [extensions](extensions/basics)
-        [extensions](extensions/basics.md)
 
 -   With long URLs, the following syntax is better.