diff --git a/gravatar/Readme.rst b/gravatar/Readme.rst
index a37335d..d467816 100644
--- a/gravatar/Readme.rst
+++ b/gravatar/Readme.rst
@@ -7,9 +7,17 @@ makes the variable available within the article's context. You can add
 address. Obviously, that email address must be associated with a Gravatar
 account.
 
-Alternatively, you can provide an email address from within article metadata::
+Alternatively, you can provide an email address from within article metadata.
+
+In ReSTructuredText::
 
     :email:  john.doe@example.com
 
-If the email address is defined via at least one of the two methods above,
-the ``author_gravatar`` variable is added to the article's context.
+In Markdown::
+
+    Email:  john.doe@example.com
+
+If the email address is defined via at least one of the two methods above, the
+``author_gravatar`` variable is added to the article's context. For markdown,
+it is critical the 'E' in Email is capitalized.
+