Skip to main content

小书匠语法说明之无序列表

概述

无序列表用来对不需要进行编号的条目进行列表显示。

使用

单级无序列表

在每一个条目前面添加*, - 或者 + 符号,就可以实现无序列表

示例

使用 * 创建的无序列表

  1. 1* 无序条目 
  2. 2* 无序条目 
  3. 3* 无序条目 

使用 - 创建的无序列表

  1. 1- 无序条目 
  2. 2- 无序条目 
  3. 3- 无序条目 

使用 + 创建的无序列表

  1. 1+ 无序条目 
  2. 2+ 无序条目 
  3. 3+ 无序条目 

效果

使用 * 创建的无序列表

  • 无序条目
  • 无序条目
  • 无序条目

使用 - 创建的无序列表

  • 无序条目
  • 无序条目
  • 无序条目

使用 + 创建的无序列表

  • 无序条目
  • 无序条目
  • 无序条目

多级嵌套无序列表

通过间隔二个以上的空隔,可以实现多级嵌套无序列表功能。

示例

  1. 1+ 无序条目 
  2. 2 + 子无序条目 
  3. 3 + 子无序条目 
  4. 4 - 孙无序条目 
  5. 5 - 孙无序条目 
  6. 6+ 无序条目 
  7. 7 * 子无序条目 
  8. 8 * 子无序条目 
  9. 9+ 无序条目 

效果

  • 无序条目
    • 子无序条目
    • 子无序条目
      • 孙无序条目
      • 孙无序条目
  • 无序条目
    • 子无序条目
    • 子无序条目
  • 无序条目

单条目多行

列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。

要让列表看起来更漂亮,你可以把内容用固定的缩进整理好:

  1. 1* Lorem ipsum dolor sit amet, consectetuer adipiscing elit. 
  2. 2 Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, 
  3. 3 viverra nec, fringilla in, laoreet vitae, risus. 
  4. 4* Donec sit amet nisl. Aliquam semper ipsum sit amet velit. 
  5. 5 Suspendisse id sem consectetuer libero luctus adipiscing. 

或者也可以写成这样

  1. 1* Lorem ipsum dolor sit amet, consectetuer adipiscing elit. 
  2. 2Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, 
  3. 3viverra nec, fringilla in, laoreet vitae, risus. 
  4. 4* Donec sit amet nisl. Aliquam semper ipsum sit amet velit. 
  5. 5Suspendisse id sem consectetuer libero luctus adipiscing. 

HTML

像下面的无序列表

  1. 1* Bird 
  2. 2* McHale 
  3. 3* Parish 

生成对应的 HTML 结构为

  1. 1<ul> 
  2. 2<li>Bird</li> 
  3. 3<li>McHale</li> 
  4. 4<li>Parish</li> 
  5. 5</ul> 

如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用 <p> 标签包起来, 比如:

  1. 1* Bird 
  2. 2 
  3. 3* McHale 

生成对应的 HTM 为:

  1. 1<ul> 
  2. 2<li> 
  3. 3<p>Bird</p> 
  4. 4</li> 
  5. 5<li> 
  6. 6<p>McHale</p> 
  7. 7</li> 
  8. 8</ul> 

无序列表与其他语法的使用

列表项目多段落

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符

  1. 1* This is a list item with two paragraphs. Lorem ipsum dolor 
  2. 2 sit amet, consectetuer adipiscing elit. Aliquam hendrerit 
  3. 3 mi posuere lectus. 
  4. 4 
  5. 5 Vestibulum enim wisi, viverra nec, fringilla in, laoreet 
  6. 6 vitae, risus. Donec sit amet nisl. Aliquam semper ipsum 
  7. 7 sit amet velit. 
  8. 8 
  9. 9* Suspendisse id sem consectetuer libero luctus adipiscing. 
  10. 10 

如果你每行都有缩进,看起来会看好很多,当然,再次地,如果你很懒惰,Markdown 也允许:

  1. 1* This is a list item with two paragraphs. 
  2. 2 
  3. 3 This is the second paragraph in the list item. You're 
  4. 4only required to indent the first line. Lorem ipsum dolor 
  5. 5sit amet, consectetuer adipiscing elit. 
  6. 6 
  7. 7* Another item in the same list. 

列表和引用

如果要在列表项目内放进引用,那 > 就需要缩进

  1. 1* A list item with a blockquote: 
  2. 2 > This is a blockquote 
  3. 3 > inside a list item. 

列表和代码块

如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:

  1. 1* 一列表项包含一个列表区块: 
  2. 2 <代码写在这> 

或者

  1. 1* 一列表项包含一个列表区块: 
  2. 2 ``` javascript 
  3. 3 var x = 1; 
  4. 4 ``` 

显示效果

  • 一列表项包含一个列表区块:
    1. 1 var x = 1

疑问

相关

  1. 有序列表
  2. 待办列表
  3. 参考了 markdown 语法说明