Items: Prefixed by plus

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

Items: Free leading spacing (indentation)

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

Items: Vertical spacing between items

  1. Let one blank line between the list items.

  2. It will be maintained on the conversion.

  3. Some targets don't support this behavior.

  4. 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 plus

+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

  1. - This is a list
  2. + This is a list
  3. : This is a list

Nesting: Creating sublists

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

Nesting: Free leading spacing (indentation)

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

Nesting: Maximum depth

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

Nesting: Reverse doesn't work

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

Nesting: Going deeper and back

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

Nesting: Vertical spacing between lists

  1. Level 1

    1. Level 2 -- blank BEFORE and AFTER (in)

      1. Level 3
        1. Level 4
      2. Level 3

    2. Level 2 -- blank BEFORE and AFTER (out)

  2. Level 1

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

      1. Level 3

Nesting: Messing up

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

Closing: Two (not so) empty lines

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

Closing: Empty item closes current (sub)list

  1. Level 1
    1. Level 2
      1. Level 3
      Level 2
    Level 1

  1. Empty item with trailing spaces.

  1. Empty item with trailing TAB.

Closing: EOF closes the lists

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