diff --git a/Documentation/markdown.md b/Documentation/markdown.md
index daaaff6..8bf28f5 100644
--- a/Documentation/markdown.md
+++ b/Documentation/markdown.md
@@ -129,6 +129,25 @@
 Like bullet lists, numbered lists can be nested by using more leading
 space than the prior list item.
 
+Paragraphs can be properly nested within lists by indenting with at
+least 2 leading spaces:
+
+```
+1. Fruit
+
+  In botany, a fruit is the seed-bearing structure in flowering
+  plants.
+
+  In common language usage, "fruit" normally means the fleshy
+  seed-associated structures of a plant that are sweet or sour, and
+  edible in the raw state, such as apples, bananas, grapes, lemons,
+  oranges, and strawberries.
+
+2. Cake
+
+  The cake is a lie.
+```
+
 ### Tables
 
 Simple tables are supported with column alignment.  The first line is