Editing Lightweight markup language (section)

=== List syntax ===
HTML requires an explicit element for the list, specifying its type, and one for each list item, but most lightweight markup languages need only different line prefixes for the bullet points or enumerated items. Some languages rely on indentation for nested lists, others use repeated parent list markers.

{{sort-under}}
{| class="wikitable sortable sort-under"
|+ Unordered, bullet list items
! {{diagonal split header|Language|Character}}
! <code><nowiki>*</nowiki></code>
! <code><nowiki>-</nowiki></code>
! <code><nowiki>+</nowiki></code>
! <code><nowiki>#</nowiki></code>
! <code><nowiki>.</nowiki></code>
!{{tooltip|2=middle dot|<code><nowiki>·</nowiki></code>}}
!{{tooltip|2=bullet|<code><nowiki>•</nowiki></code>}}
! <code><nowiki>_</nowiki></code>
! <code><nowiki>:</nowiki></code>
!{{tooltip|2=en-dash|<code><nowiki>–</nowiki></code>}}
!{{tooltip|2=em-dash|<code><nowiki>—</nowiki></code>}}
!{{tooltip|2=number of whitespace characters before the line prefix|indent}}
!{{tooltip|2=number of whitespace characters after the line prefix|skip}}
! nest
|-
! {{rh}} | [[AsciiDoc]]
| {{yes}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 0{{efn|name=asciidoc-indentation|Indenting by a single whitepace in AsciiDoc will preformat the text of that line.|group=asciidoc}} || {{dunno}} || repeat ''or'' alternate the marker
|-
! {{rh}} | [[DokuWiki]]
| {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 2+ || 0+ || indent
|-
! {{rh}} | [[Gemtext]]
| {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 0 || 1+ || {{n/a}}
|-
! {{rh}} | [[Jira (software)|Jira]]
| {{yes}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 0 || 1+ || repeat
|-
! {{rh}} | [[Markdown]]
| {{yes}} || {{yes}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 0–3 || 1–3 || indent
|-
! {{rh}} | [[MediaWiki]], [[TiddlyWiki]]
| {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 0 || 1+ || repeat
|-
! {{rh}} | [[Org-mode]]
| {{yes-no|Yes<ref>[https://orgmode.org/org.html#FOOT9 Footnote in official manual] "When using ‘*’ as a bullet, lines must be indented so that they are not interpreted as headlines. Also, when you are hiding leading stars to get a clean outline view, plain list items starting with a star may be hard to distinguish from true headlines. In short: even though ‘*’ is supported, it may be better to not use it for plain list items."</ref>}} || {{yes}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 0+ || || indent
|-
! {{rh}} | [[Textile (markup language)|Textile]]
| {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 0 || 1+ || repeat
|-
! {{rh}} | [[Texy!]]
| {{yes}} || {{yes}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 2+ || {{dunno}} || indent
|}

Microsoft Word automatically converts paragraphs that start with an asterisk <code>*</code>, hyphen-minus <code>-</code> or greater-than bracket <code>&gt;</code> followed by a space or horizontal tabulator as bullet list items. It will also start an enumerated list for the digit ''1'' and the case-insensitive letters ''a'' (for alphabetic lists) or ''i'' (for roman numerals), if they are followed by a period <code>.</code>, a closing round parenthesis <code>)</code>, a greater-than sign <code>&gt;</code> or a hyphen-minus <code>-</code> and a space or tab; in case of the round parenthesis an optional opening one <code>(</code> before the list marker is also supported.

Languages differ on whether they support optional or mandatory digits in numbered list items, which kinds of enumerators they understand (e.g. decimal digit ''1'', roman numerals ''i'' or ''I'', alphabetic letters ''a'' or ''A'') and whether they support to keep explicit values in the output format. Some Markdown dialects, for instance, will respect a start value other than 1, but ignore any other explicit value.

{{sort-under}}
{| class="wikitable sortable sort-under"
|+ Ordered, enumerated list items
! {{diagonal split header|Language|Character}}
! <code><nowiki>+</nowiki></code>
! <code><nowiki>#</nowiki></code>
! <code><nowiki>-</nowiki></code>
! <code><nowiki>.</nowiki></code>
! <code><nowiki>#1</nowiki></code>
! <code><nowiki>1.</nowiki></code>
! <code><nowiki>1)</nowiki></code>
! <code><nowiki>1]</nowiki></code>
! <code><nowiki>1}</nowiki></code>
! <code><nowiki>(1)</nowiki></code>
! <code><nowiki>[1]</nowiki></code>
! <code><nowiki>{1}</nowiki></code>
! {{tooltip|2=Lower-case letters as alternative to digits (with punctuation as for digits)|<code><nowiki>a.</nowiki></code>}}
! {{tooltip|2=Upper-case letters as alternative to digits (with punctuation as for digits)|<code><nowiki>A.</nowiki></code>}}
! {{tooltip|2=Lower-case Roman numerals (with punctuation as for digits)|<code><nowiki>i.</nowiki></code>}}
! {{tooltip|2=Upper-case Roman numerals (with punctuation as for digits)|<code><nowiki>I.</nowiki></code>}}
!{{tooltip|2=number of whitespace characters before the line prefix|indent}}
!{{tooltip|2=number of whitespace characters after the line prefix|skip}}
! nest
|-
! {{rh}} | [[AsciiDoc]]
| {{no}} || {{no}} || {{no}} || {{yes}} || {{no}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}}|| {{no}} || colspan="4" {{yes}}{{efn|The modern language specification only supports a full stop as a delimiter for any ordered list. In the legacy AsciiDoc.py syntax, only a right parenthesis was acceptable for either lower alpha or Roman numerals.|group=asciidoc}} || 0{{efn|name=asciidoc-indentation}} || {{dunno}} || repeat ''or'' alternate the marker
|-
! {{rh}} | [[DokuWiki]]
| {{no}} || {{no}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no }} || {{no}} || {{no}} || {{no}} || 2+ || 0+ || indent
|-
! {{rh}} | [[Jira (software)|Jira]], [[MediaWiki]], [[Textile (markup language)|Textile]], [[TiddlyWiki]]
| {{no}} || {{yes}} || {{no}} || {{no}} || {{no}}  || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || 0 || 1+ || repeat
|-
! {{rh}} | [[Markdown]]
| {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{yes}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no }} || {{no}} || {{no}} || {{no}} || 0–3 || 1–3 || indent
|-
! {{rh}} | [[Org-mode]]
| {{no}} || {{no}} || {{no}} || {{no}} || {{no}}  || {{yes}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || colspan="2" {{optional}} || {{no}} || {{no}} || 0+ || || indent
|-
! {{rh}} | [[Texy!]]
| {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || {{yes}} || {{yes}} || {{no}} || {{no}} || {{no}} || {{no}} || {{no}} || colspan="2" {{yes-no|Only with <code><nowiki>)</nowiki></code> delimiter}} || {{no}} || {{yes-no|Only with <code><nowiki>)</nowiki></code> delimiter}} || 2+ || {{dunno}} || indent
|-
|}

Slack assists the user in entering enumerated and bullet lists, but does not actually format them as such, i.e. it just includes a leading digit followed by a period and a space or a bullet character <code>•</code> in front of a line.

{| class="wikitable sortable"
|+ Labeled, glossary, [[definition list|description/definition list]] syntax
! Languages
! Term being defined !! Definition of the term
|-
! rowspan="3"| [[AsciiDoc]]
|<code><nowiki>Term::</nowiki></code>
| rowspan="3" |No specific requirements; may be mixed with ordered or unordered lists, with nesting optional
|-
|<code><nowiki>Term::::</nowiki></code>
|-
|<code><nowiki>Term;;</nowiki></code>

|-
! [[MediaWiki]]
|rowspan=2| <code><nowiki>; Term</nowiki></code>
|rowspan=2| <code><nowiki>: Definition</nowiki></code>
|-
! [[Textile (markup language)|Textile]]
|-
![[Texy!]]
|colspan="2" | <pre><nowiki>Term:
    - Definition</nowiki></pre>
|-
![[TiddlyWiki]]
|colspan="2" | <pre><nowiki>; Term
: Definition</nowiki></pre>
|-
! [[Org-mode]]
|colspan="2" | <code><nowiki>- Term :: Definition </nowiki></code>
|-

|}