diff --git a/src/docs/user/userguide/remarkup.diviner b/src/docs/user/userguide/remarkup.diviner
--- a/src/docs/user/userguide/remarkup.diviner
+++ b/src/docs/user/userguide/remarkup.diviner
@@ -532,10 +532,12 @@
Remarkup supports simple table syntax. For example, this:
- | Fruit | Color | Price | Peel?
- | ----- | ----- | ----- | -----
- | Apple | red | `$0.93` | no
- | Banana | yellow | `$0.19` | **YES**
+```
+| Fruit | Color | Price | Peel?
+| ----- | ----- | ----- | -----
+| Apple | red | `$0.93` | no
+| Banana | yellow | `$0.19` | **YES**
+```
...produces this:
@@ -546,26 +548,28 @@
Remarkup also supports a simplified HTML table syntax. For example, this:
-
-
- Fruit |
- Color |
- Price |
- Peel? |
-
-
- Apple |
- red |
- `$0.93` |
- no |
-
-
- Banana |
- yellow |
- `$0.19` |
- **YES** |
-
-
+```
+
+
+ Fruit |
+ Color |
+ Price |
+ Peel? |
+
+
+ Apple |
+ red |
+ `$0.93` |
+ no |
+
+
+ Banana |
+ yellow |
+ `$0.19` |
+ **YES** |
+
+
+```
...produces this: