如同Wikipedia:如何编辑页面#版式所述，列表写法的标记具有许多种写法存在。但是其中有乍看之下为正常表示，但有些实际上在看不到的地方里呈现并不理想的状态，成为各式问题的原因。

您使用维基百科的标记所编辑的文章，在被阅览时会透过名为MediaWiki的软件，转换成网页浏览器能够辨识的形式XHTML。此依标记的方式可能无法产生理想的XHTML格式。本条目页面在此举出被推荐的范例和非推荐的范例，来加以解说列表写法的标记方式。

定义的列表写法

如果打算要做的是，具有简短词汇（用语或人名之类）与相对说明组合而成的列表的话，全部依照定义的列表写法编辑最为合理。尤其是“登场人物与其解说”等情况，是用定义的列表写法来记述的理想典范。

; 用语1 : 用语1的说明
; 用语2 : 用语2的说明

<dl>
  <dt>用语1</dt>
  <dd>用语1的说明</dd>
  <dt>用语2</dt>
  <dd>用语2的说明</dd>
</dl>

用定义的列表写法所编辑的一个区块（<dl>～</dl>）之中，用语（<dt>～</dt>）和其定义（<dd>～</dd>）将成对出现。这个是被推荐的写法。

列表写法

若是单纯并不需要说明的列表，使用普通的列表写法是比较理想的。而如果其顺序是有意义的，使用带有数字的列表写法会更合适。

* foo
** bar
* hoge
** fuga
** piyo

<ul>
  <li>foo
    <ul>
      <li>bar</li>
    </ul>
  </li>
  <li>hoge
    <ul>
      <li>fuga</li>
      <li>piyo</li>
    </ul>
  </li>
</ul>

# foo
## bar
# hoge
## fuga
## piyo

<ol>
  <li>foo
    <ol>
      <li>bar</li>
    </ol>
  </li>
  <li>hoge
    <ol>
      <li>fuga</li>
      <li>piyo</li>
    </ol>
  </li>
</ol>

例1

* 用语1
: 用语1的说明
* 用语2
: 用语2的说明

<ul>
  <li>用语1</li>
</ul>
<dl>
  <dd>用语1的说明</dd>
</dl>
<ul>
  <li>用语2</li>
</ul>
<dl>
  <dd>用语2的说明</dd>
</dl>

像这个样子用列表写法所制作出的区块（<ul>～</ul>）和定义的列表写法所制作出的区块（<dl>～</dl>）交互出现，造成区块被切断了。

例2

比上面好一点的例子。

* 用语1
*: 用语1的说明
* 用语2
*: 用语2的说明

<ul>
  <li>用语1
    <dl>
      <dd>用语1的说明</dd>
    </dl>
  </li>
  <li>用语2
    <dl>
      <dd>用语2的说明</dd>
    </dl>
  </li>
</ul>

虽然列表写法的区块（<ul>～</ul>）只有一个，但是列表写法的各个构成（<li>～</li>）之中每次都产生一个定义的列表写法的区块（<dl>～</dl>）。另外一般在<dl>～</dl>之中，用语（<dt>～</dt>）和其定义（<dd>～</dd>）成对出现是最理想的，只出现<dd>～</dd>的<dl>～</dl>用法是不太好的。

例3

使用了定义的列表写法结果却失去了使用的意义。

; 用语1 : 用语1的说明

; 用语2 : 用语2的说明

<dl>
  <dt>用语1</dt>
  <dd>用语1的说明</dd>
</dl>
<dl>
  <dt>用语2</dt>
  <dd>用语2的说明</dd>
</dl>

中间夹了空白行（只有换行没写任何东西）结果造成定义的列表写法所产生的区块被分隔为两个。这样子看似是为了方便编辑，遗憾的是得到了反效果。

* 用语1

* 用语2

** 用语3

<ul>
  <li>用语1</li>
</ul>
<ul>
  <li>用语2</li>
</ul>
<ul>
  <li>
    <ul>
      <li>用语3</li>
    </ul>
  </li>
</ul>

# 用语1

# 用语2

## 用语3

<ol>
  <li>用语1</li>
</ol>
<ol>
  <li>用语2</li>
</ol>
<ol>
  <li>
    <ol>
      <li>用语3</li>
    </ol>
  </li>
</ol>

普通的列表写法与带有数字的列表写法虽然可以说是相同的情形，但是问题更加严重。尤其是带有数字的时候会造成数字不连续的悲惨状况，和普通的列表写法一样会破坏版面的显示。

“说什么XHTML，太过复杂让人搞不懂，看起来漂亮不就好了？”的确这种想法是存在的。不过要注意那是偏重于明眼人（没有视觉障碍的人）的思考方式。

具有视觉障碍的人使用声音读出浏览器来阅览维基百科。这时若遇到上述的例2会怎么读出呢？

<以下是列表>
用语1、
<以下是定义列表>
<以下是刚刚的定义词汇的说明>用语1的说明<说明结束>
<定义列表结束>
用语2、
<以下是定义列表>
<以下是刚刚的定义词汇的说明>用语2的说明<说明结束>
<定义列表结束>
<列表结束>

如何？明明没有读出定义词汇却突然跑出个“刚刚的定义词汇”，意思说不通。那么在正确范例中又是如何呢？

<以下是定义列表>
<以下是定义词汇>用语1、<定义词汇结束>
<以下是刚刚的定义词汇的说明>用语1的说明<说明结束>
<以下是定义词汇>用语2、<定义词汇结束>
<以下是刚刚的定义词汇的说明>用语2的说明<说明结束>
<定义列表结束>

这样就可以了。

另外还有传输资料量的问题。请将例1与例2所产生的XHTML，和正确范例的情况做比较。变得更加简洁了。只有一两个虽然没有太大差别在，当重复10次20次时就会出现明显的差异。

在用语后换行

定义的列表写法也可以用下面的方式来写。

; 用语1
: 用语1的说明
; 用语2
: 用语2的说明

<dl>
  <dt>用语1</dt>
  <dd>用语1的说明</dd>
  <dt>用语2</dt>
  <dd>用语2的说明</dd>
</dl>

像这样在用语后面换列结果和被推荐的范例是完全一样的。说明部分变长的时候用这种方式编辑应该会比较容易观看原始档。

比较长的说明

说明部分变长而想要分隔段落的时候，用以下的方法。

输入内容

; 用语1
: 用语1的繁长说明用语1的繁长说明用语1的繁长说明用语1的繁长说明
: 用语1的繁长说明的下个段落用语1的繁长说明的下个段落用语1的繁长说明的下个段落
; 用语2
: 用语2的繁长说明用语2的繁长说明用语2的繁长说明
: 用语2的繁长说明的下个段落用语2的繁长说明的下个段落

<dl>
  <dt>用语1</dt>
  <dd>用语1的详细说明...</dd>
  <dd>用语1的详细说明的下个段落...</dd>
  <dt>用语2</dt>
  <dd>用语2的详细说明...</dd>
  <dd>用语2详细说明的下个段落...</dd>
</dl>

用语（<dt>～</dt>）和其定义（<dd>～</dd>）没有1对1的成对，虽然不能说是最理想的状态，不过只用维基百科的标记方式无法在<dd>～</dd>之中产生段落，为了方便起见而采用这个方式。

若是说明部分太长的话，也请检讨使用标题分出一个章节来写。

嵌套

代码：

# 内容1
#* 内容11
#* 内容12
# 内容2
## 内容21
## 内容22

效果：

1. 内容1
   • 内容11
   • 内容12
2. 内容2
   1. 内容21
   2. 内容22

其他

说明部分如果相当地短，惯例上常用以下的形式。

* 用语1 - 用语1的说明
* 用语2 - 用语2的说明

有时候会有，对标记方法理解不足、或是因为“这样子比较好看”的理由，而使用不被推荐的标记方法。比方说在定义的列表写法，有人会讨厌把用语强制改成粗体字，也有人会讨厌在列举事项时前面多了个点。

但是请别忘了，每个人对好看的感觉不同，以及在您的使用环境下所看到的样子不见得和其他人一样。虽然多数人使用着标准的MonoBook面版，也可能有人使用cairn blue，或是使用独创的用户CSS。当改变使用环境，即使再怎么调整版面的样貌也是没有意义的。

结果是使用被推荐的写法来标记，会是符合最多人的阅览方式（包含声音浏览器）的最佳捷径。

若是搞不懂、记不住在此所解说的内容的话，请先忽略它。与其烦恼怎么标记，不如把心力花在记述优良的条目上。即使标记错误，以后也会有某个人帮忙修正（这是Wiki系统的一大优点）。看了其他人修改的方法，迟早也能学会更好的写法吧。

当发现用被推荐的写法改过的文章，被回复成不被推荐的写法时，请教导出这个页面的存在，说明修改的理由。因为做出回复的大多是新手，请不要强硬逼迫，亲切地做出说明。也请参考Wikipedia:不要伤害新手。

• Wikipedia:格式手册
• Wikipedia:琐碎章节

• Wikipedia:列表
• ((·)) and ((•)) - Dots and bullets for horizontal link lists, such as in navboxes, which look like lists, but do not use HTML list mark-up.
  • ((flatlist)) - for a more semantically-correct and accessible way of marking up such lists.
• Wikipedia:Line break handling - 间隔处理Covers among other things how to properly handle the line wrapping in horizontal link lists.