aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README8
1 files changed, 5 insertions, 3 deletions
diff --git a/README b/README
index 5d8778daf..d36068dfa 100644
--- a/README
+++ b/README
@@ -1027,9 +1027,11 @@ Pandoc supports definition lists, using a syntax inspired by
Each term must fit on one line, which may optionally be followed by
a blank line, and must be followed by one or more definitions.
A definition begins with a colon or tilde, which may be indented one
-or two spaces. A term may have multiple definitions, and each definition
-may consist of one or more block elements (paragraph, code block, list,
-etc.), each indented four spaces or one tab stop.
+or two spaces. The body of the definition (including the first line,
+aside from the colon or tilde) should be indented four spaces. A term may have
+multiple definitions, and each definition may consist of one or more block
+elements (paragraph, code block, list, etc.), each indented four spaces or one
+tab stop.
If you leave space after the definition (as in the example above),
the blocks of the definitions will be considered paragraphs. In some