其实Markdown就是一种易于编写的普通文本,只不过加入了可渲染文本的「标记」而已。最终依然会转换为HTML文档。在使用Markdown时,注意「标记符」后面必须加空格,否则会格式混乱。

1. Markdown 标题

Markdown支持6种级别的标题,对应HTML标签<h1>到<h6>

# 一级标题(<h1>)
## 二级标题(<h2>)
### 三级标题(<h3>)
#### 四级标题(<h4>)
##### 五级标题(<h5>)
###### 六级标题(<h6>

一级标题(<h1>)

二级标题(<h2>)

三级标题(<h3>)

四级标题(<h4>)

五级标题(<h5>)
六级标题(<h6>)

除此之外,Markdown还支持Setext-style形式标题,使用下划线控制文本大小

这是一级标题
===
这是二级标题
---

一级标题(Setext-style)

二级标题(Setext-style)

使用Setext-style方式处理标题仅有两种表现形式,即一级标题和二级标题。这种方式在Github的一些开源项目上面比较常见,很明显的的缺点是:支持的文字大小级别有限。

2. Markdown 段落

使用Markdown分段非常简单,前后至少保留一个空行即可,多个空格跟一个空格是一样的效果。

3. Markdown 区块引用

我们希望对某段文字进行强调,或者这段文字来自某名人和网站时,Markdown提供了一个特殊符号>用于段首进行强调,被强调的文字部分将会高亮显示,对应生成<blockquote> HTML标签。

> 大于符号后的内容形成引用块

大于符号后的内容形成引用块

4. Markdown 插入链接

[Linux命令大全](https://www.rdtoc.com/commands/linux.html)

<admin@rdtoc.com>
Linux命令大全

admin@rdtoc.com

5. Markdown 插入图片

![图片alt说明](https://emeraldartcenter.org/wp-content/uploads/2018/01/header-background-dark.jpg)
图片alt说明

6. Markdown 有序列表

有序列表用数字加点 . 表示,如:1. ,对于有序列表,Markdown不关心编号是多少,只要格式正确,解析器自动编排,下面四个项目编号都是1,最终显示为1、2、3、4。

1. 蒸羊羔
1. 蒸熊掌
1. 蒸鹿尾儿
1. 烧花鸭
  1. 蒸羊羔
  2. 蒸熊掌
  3. 蒸鹿尾儿
  4. 烧花鸭

Markdown 还支持层级列表,要在列表中添加子列表,只需要保证子列表前加tab即可,tab可用空格代替,但要注意,不同的Markdown解析器空格数可能不同,请自行尝试。这种效果同样适用于无序列表。

1. 我喜欢吃
    1. 蒸羊羔
    1. 蒸熊掌
    1. 蒸鹿尾儿
    1. 烧花鸭
1. 我不喜欢吃
    1. 烧雏鸡
    1. 烧子鹅
    1. 卤猪
    1. 卤鸭

  1. 我喜欢吃
    1. 蒸羊羔
    2. 蒸熊掌
    3. 蒸鹿尾儿
    4. 烧花鸭
  2. 我不喜欢吃
    1. 烧雏鸡
    2. 烧子鹅
    3. 卤猪
    4. 卤鸭

7. Markdown 无序列表

无序列表用*号、+号或-号表示都可以,请看实例,实例中的反斜杠 \ 表示转义,告诉Markdown解析器不需要编译,直接显示「标记符」,后续章节有专门讲解Markdown 特殊符转义

\* 号无序列表

* 蒸羊羔
* 蒸熊掌
* 蒸鹿尾儿
* 烧花鸭

\+ 号无序列表

+ 蒸羊羔
+ 蒸熊掌
+ 蒸鹿尾儿
+ 烧花鸭

\- 号无序列表

- 蒸羊羔
- 蒸熊掌
- 蒸鹿尾儿
- 烧花鸭

* 号无序列表

  • 蒸羊羔
  • 蒸熊掌
  • 蒸鹿尾儿
  • 烧花鸭

+ 号无序列表

  • 蒸羊羔
  • 蒸熊掌
  • 蒸鹿尾儿
  • 烧花鸭

- 号无序列表

  • 蒸羊羔
  • 蒸熊掌
  • 蒸鹿尾儿
  • 烧花鸭

8. Markdown 分隔线

有时候,为了排版美观,可能会加入分隔线。Markdown加入分隔线非常简单,不小于三个减号即可。

---


9. Markdown 强调

有时候,我们希望强调某段文字,使用*号或下划线_包裹即可。使用一个「标记符」表示斜体,两个「标记符」表示加粗。

*我是斜体*
_我是斜体_

**我被加粗了**
__我被加粗了__

我是斜体 我是斜体

我被加粗了 我被加粗了