diff --git a/doc/markdown/markdown.md b/doc/markdown/markdown.md
index 2bbe4b2a36e..1761487b6ca 100644
--- a/doc/markdown/markdown.md
+++ b/doc/markdown/markdown.md
@@ -1,5 +1,10 @@
 # Markdown
 
+> **Note:**
+> Not all of the GitLab-specific extensions to Markdown that are described in this document currently work on our documentation website.
+> 
+> For the best result, we encourage you to check this document out as rendered by GitLab: [markdown.md](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/markdown/markdown.md).
+
 ## Table of Contents
 
 **[GitLab Flavored Markdown](#gitlab-flavored-markdown-gfm)**