## Items: Prefixed by hyphen

- Use the hyphen to prefix list items.
- There must be one space after the hyphen.
- 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 hyphen

-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
      - hyphen 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.