document that paragraphs in normal table cells are separated by the height of one line

2 files changed, 8 insertions, 2 deletions

diff --git a/docs/modules/theme/pages/prose.adoc b/docs/modules/theme/pages/prose.adoc
index ae229729..268e4d59 100644
--- a/docs/modules/theme/pages/prose.adoc
+++ b/docs/modules/theme/pages/prose.adoc
@@ -6,7 +6,7 @@
 [#prose]
 == prose
 
-The keys in the `prose` category control the spacing below paragraphs, lists, and index categories.
+The keys in the `prose` category control the spacing below paragraphs (but not paragraphs in a normal table cell), lists, and index categories.
 The bottom margin is only added if the block is followed by an adjacent block within the same enclosure (e.g., a sidebar, a table cell, or the area outside a block).
 
 [cols="3,4,5a"]
@@ -53,4 +53,3 @@ It's useful when using indented paragraphs.
 
 The `text-indent-inner` key is only applied to inner paragraphs.
 Inner paragraphs are paragraphs that follow an adjacent paragraph.
-
diff --git a/docs/modules/theme/pages/tables.adoc b/docs/modules/theme/pages/tables.adoc
index c37716e2..f13cc678 100644
--- a/docs/modules/theme/pages/tables.adoc
+++ b/docs/modules/theme/pages/tables.adoc
@@ -206,3 +206,10 @@ table:
   caption:
     end: bottom
 ----
+
+[#table-cell-paragraphs]
+== Table cell paragraphs
+
+Except for AsciiDoc table cells, paragraphs in a table cell are always separated by the height of one line.
+This spacing cannot be controlled directly by the theme.
+If you require control over the spacing between paragraphs in a table cell, convert that table cell to an AsciiDoc table cell by adding the `a` style.