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.