diff --git a/src/docs/userguide/remarkup.diviner b/src/docs/userguide/remarkup.diviner
index a93c6db46d..d999a86ef2 100644
--- a/src/docs/userguide/remarkup.diviner
+++ b/src/docs/userguide/remarkup.diviner
@@ -27,7 +27,7 @@ These are inline styles, and can be applied to most text:
   [[wiki page | name]]      # Named link to Phriction
   http://xyz/               # Link to web
   [[http://xyz/ | name]]    # Named link to web
-
+  [name](http://xyz/)       # Alternate Link
 
 These are block styles, and must be separated from surrounding text by
 empty lines:
@@ -261,6 +261,10 @@ work within Phabricator or on the internet at large:
   [[/herald/transcript/ | Herald Transcripts]]
   [[http://www.boring-legal-documents.com/ | exciting legal documents]]
 
+Markdown-style links are also supported:
+
+  [Toil](http://www.trouble.com)
+
 = Linking to Objects =
 
 You can link to Differential revisions, Diffusion commits and Maniphest tasks