diff --git a/1.0-specification.norg b/1.0-specification.norg index 6a896d4..ffcc91b 100644 --- a/1.0-specification.norg +++ b/1.0-specification.norg @@ -130,12 +130,17 @@ version: 1.0 ** Paragraphs Paragraphs are then formed of consecutive {** paragraph segments}. A paragraph is terminated by: - - A (two consecutive {*** line endings}) + - A {$ paragraph break} - Any of the {* detached modifiers} - Any of the {** delimiting modifiers} - Any of the {** ranged tags} - Any of the {*** strong carryover tags} + $ Paragaph Break + A paragraph break is defined as an _empty line_. In the simplest case that means two consecutive + {*** line endings} but since Neorg is a /free-form/ markup language, a line which only contains + whitespace is also considered empty. + * Detached Modifiers Norg has several detached modifiers. The name originates from their differentiation to the {* attached modifiers}, which will be discussed later. @@ -241,8 +246,8 @@ version: 1.0 Furthermore, in contrast to most other (standard) {* detached modifiers}, this detached modifier type has /no/ title, and affects the following `paragraph` instead of only the next {# paragraph segments}[paragraph segment]. Said paragraph then becomes the modifier's /content/. - This means that in order to terminate the detached modifier contents, you need two consecutive - {*** line endings} (see {# paragraph break}). + This means that in order to terminate the detached modifier contents, you need an empty line (see + {$ paragraph break}). Below you will find some examples of nestable detached modifiers. @@ -460,7 +465,7 @@ version: 1.0 ** Grouping Both nestable and range-able detached modifiers have a unique quality - when several consecutive modifiers /of the same type/ are encountered (by consecutive we mean _NOT_ separated via a - {# paragraph break}), they are treated as one whole . This is crucial to understand as + {$ paragraph break}), they are treated as one whole . This is crucial to understand as it is required for the many types of {** carryover tags} to function. *** Examples @@ -482,7 +487,7 @@ version: 1.0 |example - List item in one list - - This item is in another list, because we used a {# paragraph break} to split these items + - This item is in another list, because we used a {$ paragraph break} to split these items |end ** Delimiting Modifiers @@ -1078,7 +1083,7 @@ version: 1.0 +name attached modifier range - :: {* Attached modifiers} can only span at maximum a single {# paragraphs}[paragraph], i.e. they get - terminated as soon as they encounter a {# paragraph break}. + terminated as soon as they encounter a {$ paragraph break}. This means that this: |example @@ -1086,7 +1091,7 @@ version: 1.0 text* |end - will *not* result in any bold text, as it's divided by a {# paragraph break}. + will *not* result in any bold text, as it's divided by a {$ paragraph break}. However, this: |example *this