Differences

This shows you the differences between two versions of the page.

--- doc:linebreaks_and_spaces [2026/03/31 14:24] – [Be careful about blank lines] Simon Grant
+++ doc:linebreaks_and_spaces [2026/04/04 19:01] (current) – [Be careful about blank lines] Simon Grant
@@ Line 7: / Line 7: @@
 ----
-In HTML, the line breaks and paragraph breaks are coded explicitly, so it doesn't matter how you actually set out your file. It's very different in all lightweight markup languages, and this is one of the main causes of not getting the page to show as you intend. So here is what we hope is most useful for editing our wiki pages.
+In HTML, the line breaks and paragraph breaks are coded explicitly, so it doesn't matter how you actually set out the text in your file. It's quite different in all lightweight markup languages, and this is one of the main causes of not getting the page to show as you intend. So here is what we hope is most useful for editing our wiki pages.
 ===== Be careful about blank lines =====
@@ Line 17: / Line 17: @@
 * both should have blank lines after them
 * Blank lines are needed before Markdown-syntax headings: no harm in having them before and after headings in any case
+* Paragraphs need a blank line between them.
 ===== Blank spaces =====
@@ Line 67: / Line 68: @@
 As these two conventions don't conflict, both of them work here.
-==== Space in Markdown lists ====
+==== No space at the end of Markdown list items ====
-A strange quirk is that you must not put blank spaces at the end of Markdown list items. Again, it messes up the formatting.
+A strange quirk is that you must not put blank spaces at the end of Markdown list item lines. Again, it messes up the formatting.