diff --git a/src/docs/userguide/remarkup.diviner b/src/docs/userguide/remarkup.diviner
index d873e1c1e9..5f470b6632 100644
--- a/src/docs/userguide/remarkup.diviner
+++ b/src/docs/userguide/remarkup.diviner
@@ -27,6 +27,7 @@ formatting text in Remarkup:
   @username         # Mention a user
   Use "- " or "* " for list items.
   Use ``` or indent two spaces for code.
+  Use %%% for a literal block.
 
 = Basic Styling =
 
@@ -207,4 +208,15 @@ You can also use this as an explicit syntax for other web links, either within
 Phabricator or on the internet at large:
 
   [[/herald/transcript/ | Herald Transcripts]]
-  [[http://www.boring-legal-documents.com/ | exciting legal documents]]
\ No newline at end of file
+  [[http://www.boring-legal-documents.com/ | exciting legal documents]]
+
+= Literal Blocks =
+
+To place text in a literal block use "%%%":
+
+  %%%Text that won't be processed by remarkup
+  [[http://www.example.com | example]]
+  %%%
+
+Remarkup will not process the text inside of literal blocks (other than to
+escape HTML, linkify URLs, and preserve line breaks).