From 8af6b484951074d7237e0627c982b9c37cd61ddb Mon Sep 17 00:00:00 2001 From: Jack Baldry Date: Tue, 24 Oct 2023 14:53:53 +0100 Subject: [PATCH] Add instruction for multiple paragraphs with automatic numbering (#358) Signed-off-by: Jack Baldry Co-authored-by: J Stickler --- docs/sources/write/markdown-guide/index.md | 28 ++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/docs/sources/write/markdown-guide/index.md b/docs/sources/write/markdown-guide/index.md index 12ae5abca..48f773025 100644 --- a/docs/sources/write/markdown-guide/index.md +++ b/docs/sources/write/markdown-guide/index.md @@ -160,8 +160,32 @@ Use repetitive list numbering, to avoid inconsistent list numbering: The preceding list displays as: 1. First -2. Second -3. Third +1. Second +1. Third + +When writing paragraphs as list entries, you must use proper indentation. +Each line in the entry must have three spaces before the first word. +Each new paragraph must have an empty line before it. + +For example: + +```markdown +1. First paragraph in first entry. + Second sentence in first paragraph. + + Second paragraph in first entry. + +1. First paragraph in second entry. +``` + +The example displays as follows: + +1. First paragraph in first entry. + Second sentence in first paragraph. + + Second paragraph in first entry. + +1. First paragraph in second entry. ## Unordered lists