8.2 @itemize: Making an Itemized List

The @itemize command produces a sequence of “items”, each starting with a bullet or other mark inside the left margin, and generally indented.

Begin an itemized list by writing @itemize at the beginning of a line. Follow the command, on the same line, with a Texinfo command or character to generate a mark. Usually, you will use @bullet after @itemize, but you can use @minus, or any other Texinfo command or character. If you don’t specify a mark command, the default is @bullet.

After the @itemize, write your items, each starting with @item. Text can follow on the same line as the @item. The text of an item can continue for more than one paragraph.

Here is an example of the use of @itemize:

@itemize @bullet{}
@item
Some text for foo.

@item
Some text
for bar.
@end itemize

This produces:

When you give a mark command such as @bullet as the argument to @itemize command, you may omit the ‘{}’ that would normally follow the command.

If you don’t want any mark at all, but still want logical items, use @w{} (in this case the braces are required).

There should be at least one @item inside the @itemize environment. If none are present, texi2any gives a warning. If you just want indented text and not a list of items, use @indentedblock; see @indentedblock: Indented text blocks.

Index entries that occur immediately before an @item are associated with the @item.

Usually, you should put a blank line between items. This puts a blank line in the Info file. (TeX inserts the proper vertical space in any case.) Except when the entries are very brief, these blank lines make the list look better.

Itemized lists may be embedded within other itemized lists. Here is a list marked with dashes embedded in a list marked with bullets:

@itemize @bullet{}
@item
First item.

@itemize @minus{}
@item
Inner item.

@item
Second inner item.
@end itemize

@item
Second outer item.
@end itemize

This produces: