# Lists and sub-lists - PGML

## Bullet Lists

To create a bullet list, start each item with an asterisk or dash followed by a space.

``` This is a list:
* Item 1
* Item 2

This is a second list:
- Item 1
- item 2
```

You can get different shapes for the bullet by using a plus rather than an asterisk to get square bullets, and an "o" to get open bullets.

``` + Item 1 with square bullets
+ Item 2 with square bullets

o Item 1 with open bullets
o item 2 with open bullets
```

## Numbered Lists

To produce a numbered list, start each item with a number followed by a period and a space.

``` This is a numbered list:
1. Item 1
2. Item 2
```

The actual number used doesn't matter; PGML will start the numbering at 1 and increment by 1 for each item. So

``` 8. Item A
1. Item B
3. Item C
```

still produces

1. Item A
2. Item B
3. Item C

## Alphabetic Lists

To create an alphabetic list, start each item with a letter followed by a period or close parenthesis followed by a space.

``` This is a list with alphabetic labels:
a) Item 1
b) Item 2

Or

a. Item 1
b. Item 2
```

If you use upper-case letters, the labels will be in upper case.

``` A) Item 1
B) Item 2
```

As with numeric lists, it doesn't matter what letters you actually use, so

``` a. Item 1
a. Item 2
a. Item 3
```

produces a list with labels "a", "b", and "c".

## Roman Numerals

To get a list with Roman numerals, start each item with a roman numeral follow by a period or close parenthesis and a space.

``` i. Item 1
ii. Item 2
iii. Item 3
iv. Item 4
```

As with numeric and alphabetic lists, it doesn't matter what Roman numerals you use, so

``` i. Item 1
i. Item 2
i. Item 3
i. Item 4
```

will generate the same result as the previous list.

To get upper-case Roman numerals, use upper-case letters.

``` I. Item 1
II. Item 2
```

## Sub-Lists

To get a list within a list, simply indent the inner list with four spaces.

``` 1.  An item with a sub-list
- Bullet item 1
- Bullet item 2
2.  Back to the numbered list
```

## List and indentation

If an item runs longer than a line, you can indent the second and following lines to make it easier to read.

``` * An item that runs over
several lines can be indented.
* But it doesn't have to be,
so this is still part of the second
bullet item.
```

## Lists and Paragraphs

You can put blank lines between the items to get them separated by paragraph breaks.

``` * Item 1

* Item 2, with a separation between them
```

To end a list, start a new unindented paragraph.

``` This is a list
1. Item A
2. Item B

This is a new paragraph.
```

Note, however, that

``` This is a list
1. Item A
2. Item B

1. Item C
```

does not start a new list, it produces a three-item list (numbered 1, 2, and 3) with a paragraph break between the second and this items. In order to start a new list without an intervening paragraph, end the last line of the first list with three spaces (marked as underscores below):

``` This is a list
1. Item A
2. Item B___

1. Item C
```

produces two numbered lists, the first with two items and the second with one.

If a list item consists of more than one paragraph, put four spaces at the beginning of the second paragraph. That will keep the paragraph with the previous list item.

``` 1.  This is an item with two paragraphs

This is the item's second paragraph (it doesn't end the list).

2.  This is the next item in the same list.
```