markdown rules - specifying that internal hyperlinks should use absolute paths...

markdown rules - specifying that internal hyperlinks should use absolute paths with preceding slashes

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.