How are lists formatted in HTML?
If list formatting looks strange, first check that you understand list markup. • By default, HTML browsers indent lists relative to their context. This follows a long tradition in browsers (but isn’t so established in print). If you don’t like it, you should change the stylesheet. This is different from how lists look in reStructuredText source. Extra indentation in the source indicates a blockquote, resulting in too much indentation in the browser. • A list item can contain multiple paragraphs etc. In complex cases list items are separated by vertical space. By default this spacing is omitted in “simple” lists. A list is simple if every item contains a simple paragraph and/or a “simple” nested list. For example: • text • simple • simple • simple • simple text after a nested list • multiple paragraphs In this example the nested lists are simple (and should appear compacted) but the outer list is not. If you want all lists to have equal spacing, disable the compact_lists setting (–no-c
If list formatting looks strange, first check that you understand list markup. • By default, HTML browsers indent lists relative to their context. This follows a long tradition in browsers (but isn’t so established in print). If you don’t like it, you should change the stylesheet. This is different from how lists look in reStructuredText source. Extra indentation in the source indicates a blockquote, resulting in too much indentation in the browser. • A list item can contain multiple paragraphs etc. In complex cases list items are separated by vertical space. By default this spacing is omitted in “simple” lists. A list is simple if every item contains a simple paragraph and/or a “simple” nested list. For example: • text • simple • simple • simple • simple text after a nested list • multiple paragraphs In this example the nested lists are simple (and should appear compacted) but the outer list is not.
