diff --git a/src/docs/userguide/remarkup.diviner b/src/docs/userguide/remarkup.diviner
index 2e218ec07e..7840a67814 100644
--- a/src/docs/userguide/remarkup.diviner
+++ b/src/docs/userguide/remarkup.diviner
@@ -38,7 +38,7 @@ empty lines:
   Use "- " or "* " for bulleted lists, and "# " for numbered lists.
   Use ``` or indent two spaces for code.
   Use %%% for a literal block.
-  Use <table>...</table> for tables.
+  Use | ... | ... for tables.
 
 = Basic Styling =
 
@@ -359,7 +359,21 @@ escape HTML and preserve line breaks).
 
 = Tables =
 
-Remarkup supports a simplified HTML table syntax. For example, this:
+Remarkup supports simple table syntax. For example, this:
+
+  | Fruit  | Color  | Price   | Peel?
+  | -----  | -----  | -----   | -----
+  | Apple  | red    | `$0.93` | no
+  | Banana | yellow | `$0.19` | **YES**
+
+...produces this:
+
+| Fruit  | Color  | Price   | Peel?
+| -----  | -----  | -----   | -----
+| Apple  | red    | `$0.93` | no
+| Banana | yellow | `$0.19` | **YES**
+
+Remarkup also supports a simplified HTML table syntax. For example, this:
 
   <table>
     <tr>
diff --git a/src/infrastructure/markup/PhabricatorMarkupEngine.php b/src/infrastructure/markup/PhabricatorMarkupEngine.php
index 093fe16716..b54f170e3b 100644
--- a/src/infrastructure/markup/PhabricatorMarkupEngine.php
+++ b/src/infrastructure/markup/PhabricatorMarkupEngine.php
@@ -453,6 +453,7 @@ final class PhabricatorMarkupEngine {
     $blocks[] = new PhutilRemarkupEngineRemarkupCodeBlockRule();
     $blocks[] = new PhutilRemarkupEngineRemarkupNoteBlockRule();
     $blocks[] = new PhutilRemarkupEngineRemarkupTableBlockRule();
+    $blocks[] = new PhutilRemarkupEngineRemarkupSimpleTableBlockRule();
     $blocks[] = new PhutilRemarkupEngineRemarkupDefaultBlockRule();
 
     $custom_block_rule_classes = $options['custom-block'];