Unordered List
Unordered lists are a simple, flexible way to present related items without implying a sequence or priority. They’re ideal for grouping features, examples, tools, or short tips.
When to use
- Presenting examples or options that have no required order.
- Listing features, pros, or characteristics.
- Displaying short, scannable items in user interfaces or documentation.
Structure and syntax
- In plain text, use bullets like -, , or •.
- In HTML, use the
- element with
- items:
html
<ul><li>First item</li> <li>Second item</li> <li>Third item</li></ul> - In Markdown, use -, , or + at line start:
- Item one
- Item two
- Item three
- items:
Writing tips
- Keep items short and parallel in structure (start each with the same part of speech).
- Use sentence fragments for brevity or full sentences when explanation is needed.
- Group related items together; consider sub-lists for hierarchy.
- Avoid mixing many different types of content (e.g., full paragraphs and single words) in one list.
Accessibility
- Ensure list semantics are preserved (use proper HTML tags) for screen readers.
- Add descriptive headings to give context for the list’s purpose.
Examples
- Shopping list:
- Milk
- Eggs
- Bread
- Feature list for a port-mapping tool:
- Simple GUI
- Local port forwarding
- Logging and diagnostics
Unordered lists improve readability and make information easier to scan—use them whenever order doesn’t matter.
Leave a Reply