Items: Prefixed by colon

Use the colon to prefix list items.
There must be one space after the colon.
The list is closed by two consecutive blank lines.

Items: Free leading spacing (indentation)

The list can be indented on the source document.
You can use any number of spaces.
The result will be the same.

Items: Vertical spacing between items

Let one blank line between the list items.

It will be maintained on the conversion.

Some targets don't support this behavior.

This one was separated by a line with blanks.
You can also put a blank line inside

the item contents and it will be preserved.

Items: Exactly ONE space after the colon

:This is not a list (no space)

This is not a list (more than one space)

: This is not a list (a TAB instead the space)

Items: Catchy cases

- This is a list
+ This is a list
: This is a list

Nesting: Creating sublists

This is the "mother" list first item.
Here is the second, but inside this item,
there is a sublist, with its own items.
Note that the items of the same sublist
must have the same indentation.
And this can go on, opening sublists.
Just add leading spaces before the
colon and sublists will be opened.
The two blank lines closes them all.

Nesting: Free leading spacing (indentation)

When nesting lists, the additional spaces are free.
You can add just one,
or many.
What matters is to put more than the previous.
But remember that the other items of the same list
must use the same indentation.

Nesting: Maximum depth

There is not a depth limit,
you can go deeper and deeper.
But some targets may have restrictions.
The LaTeX maximum is here, 4 levels.
This one and the following sublists
are moved up to the level 4
when converting to LaTeX.
On the other targets,
it is just fine
to have a very deep list.

Nesting: Reverse doesn't work

Reverse nesting doesn't work.
Because a sublist *must* have a mother list.
It's the list concept, not a txt2tags limitation.
All this sublists will be bumped to mother lists.
At level 1, like this one.

Nesting: Going deeper and back

Level 1
Level 2
Level 3
Level 4
Level 3 -- (closed Level 4)
Level 2 -- (closed Level 3)
Level 1 -- (closed Level 2)
Level 1
Level 2
Level 3
Level 4
Level 1 -- (closed Level 4, Level 3 and Level 2)

Nesting: Vertical spacing between lists

Level 1

Level 2 -- blank BEFORE and AFTER (in)

Level 3
Level 4
Level 3

Level 2 -- blank BEFORE and AFTER (out)

Level 1

Level 2 -- blank BEFORE (spaces) and AFTER (TAB)

Level 3

Nesting: Messing up

Level 1
Level 2
Level 3
Level 4
Level 3.5 ???
Level 3
Level 2.5 ???
Level 2
Level 1.5 ???
Level 1

Closing: Two (not so) empty lines

This list is closed by a line with spaces and other with TABs
This list is NOT closed by two comment lines
This list is closed by a line with spaces and TAB,
then a comment line, then an empty line.

Closing: Empty item closes current (sub)list

Level 1
Level 2
Level 3
Level 2
Level 1

Empty item with trailing spaces.

Empty item with trailing TAB.

Closing: EOF closes the lists

If the end of the file (EOF) is hit,
all the currently opened list are closed,
just like when using the two blank lines.