This repository has been archived by the owner on Jan 27, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy path00001007030200.zettel
147 lines (132 loc) · 2.88 KB
/
00001007030200.zettel
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
title: Zettelmarkup: Nested Lists
tags: #manual #zettelmarkup #zettelstore
syntax: zmk
role: manual
There are thee kinds of lists that can be nested: ordered lists, unordered lists, and quotation lists.
Ordered lists are specified with the number sign (""''#''"", ''U+0023''), unordered lists use the asterisk (""''*''"", ''U+002A''), and quotation lists are specified with the greater-than sing (""''>''"", ''U+003E'').
Let's call these three characters //list characters//.
Any nested list item is specified by a non-empty sequence of list characters, followed by a space character and a sequence of inline elements.
In case of a quotation list as the last list character, the space character followed by a sequence of inline elements is optional.
The number / count of list characters gives the nesting of the lists.
If the following lines should also be part of the list item, exactly the same number of spaces must be given at the start the each following line as it is the lists are nested, plus one additional space character. In other words: the inline elements must start at the same column as it was on the previous line.
The resulting sequence on inline elements is merged into a paragraph.
Appropriately indented paragraphs can specified after the first one.
Since each blocks-structured element has to be specified at the first position of a line, none of the nested list items may contain anything else than paragraphs.
Some examples:
```zmk
# One
# Two
# Three
```
is rendered in HTML as
:::example
# One
# Two
# Three
:::
Similar an unordered list:
```zmk
* A
* B
* C
```
is rendered in HTML as
:::example
* A
* B
* C
:::
A quotation list is in most cases not a real list.
Mostly, it results by copying replies from emails:
```zmk
> Please add some
> more parsers to
> the Zettelstore software.
```
is rendered in HTML as
:::example
> Please add some
> more parsers to
> the Zettelstore software.
:::
You can freely mix these three types of nested lists.
And you can nest them:
```zmk
* A
*# A.1
*# A.2
*#* A.2.a
*#* A.2.b
*#> Quote A.2.b.I
*#># A.2.b.I.1
*#># A.2.b.I.2
*# A.3
* B
* C
```
is rendered in HTML as:
:::example
* A
*# A.1
*# A.2
*#* A.2.a
*#* A.2.b
*#> Quote A.2.b.I
*#># A.2.b.I.1
*#># A.2.b.I.2
*# A.3
* B
* C
:::
Please note that two lists cannot be separated by an empty line.
Instead you should place a horizonal rule (""thematic break"") between them.
You could also use a mark element or a hard line break to separate the two lists:
```zmk
# One
# Two
[!sep]
# Uno
# Due
---
# Eins
# Zwei
\
# Une
# Deux
```
is rendered in HTML as
:::example
# One
# Two
[!sep]
# Uno
# Due
---
# Eins
# Zwei
\
# Une
# Deux
:::
Here an example using multiple paragraphs:
```zmk
* Para A-1
Para A-2
* Para B-1
(continued)
Para B-2
** Para B.b-1
Para B.b-2
Para B-3
```
is rendered in HTML as
:::example
* Para A-1
Para A-2
* Para B-1
(continued)
Para B-2
** Para B.b-1
Para B.b-2
Para B-3
:::