基本语法

标题

在想要设置为标题的文字前面加#来表示
一个#是一级标题,二个#是二级标题,以此类推。支持六级标题,对应html标签 h1 ~ h6。

注:标准语法一般在#后跟个空格再写文字。

示例:

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

除此之外,Markdown还支持另外一种形式的标题展示形式,其类似于 Setext 标记语言的表现形式,使用下划线进行文本大小的控制

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

使用这种方式处理标题仅有两种表现形式,即一级标题和二级标题。
这种处理方式在Github的一些开源工程上面比较常见,显而易见的缺点是:文字大小控制级别有限。

段落

字体

斜体

要倾斜的文字左右分别用一个*号或_包起来
示例:

*这是倾斜的文字*
_这是倾斜的文字_

这是倾斜的文字
这是倾斜的文字

加粗

要加粗的文字左右分别用两个*号或_包起来
示例:

**这是加粗的文字**
__这是加粗的文字__

这是加粗的文字
这是加粗的文字

斜体加粗

要倾斜和加粗的文字左右分别用三个*号或_包起来
示例:

***这是斜体加粗的文字***
___这是斜体加粗的文字___

这是斜体加粗的文字这是斜体加粗的文字

删除线

要加删除线的文字左右分别用两个~~号包起来
示例:

~~这是斜体加粗的文字~~

这是斜体加粗的文字

分割线

三个或者三个以上的 - 或者 * 或者 _ 都可以。

示例:

---
----
***
*****

效果如下:




下划线

下划线可以通过HTML的标签来实现

<u>带下划线文本</u>

换行

换行直接敲回车是不行的,在有些编译器里是不会换行的。解决办法是换行后敲至少两个空格,或敲两个空格后再回车换行。

列表

无序列表

语法:
无序列表用 - + * 任何一种都可以

- 列表内容
+ 列表内容
* 列表内容

注意:- + * 跟内容之间都要有一个空格

效果如下:

  • 列表内容
  • 列表内容
  • 列表内容

有序列表

语法:
数字加点

1. 列表内容
2. 列表内容
3. 列表内容

注意:序号跟内容之间要有空格

效果如下:

  1. 列表内容
  2. 列表内容
  3. 列表内容

注:这里比较有趣的地方是,对于有序列表,Markdown将只关注你的第一个项目的数字编号。例如:如果第一个项目编号是3,以此类推,第二个项目应该是4,最终将显示为3、4、5。而如果你指定了第一个编号,后面的编号指定错误也没有关系,Markdown将只在乎你的第一个项目编号。(PS:好像不是那么正确)

列表嵌套

上一级和下一级之间敲三个空格即可

  • 一级无序列表内容

    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
  • 一级无序列表内容

    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容
  1. 一级有序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
  2. 一级有序列表内容
    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

区块

引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个...

示例:

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

效果如下:

这是引用的内容

这是引用的内容

区块中使用列表

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项

列表中使用区块

如果要在列表项目内放进区块,那么就需要在>前添加四个空格和缩进。

* 第一项
    > Markdown教程
    > 学的不仅是技术更是梦想
* 第二项

表格

语法:

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。

  • 有一个就行,为了对齐,多加了几个
  • 文字默认居左
  • 两边加:表示文字居中
  • 右边加:表示文字居右
    注:原生的语法两边都要用 | 包起来。此处省略

示例:

姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟

效果如下:

姓名技能排行
刘备大哥
关羽二哥
张飞三弟

代码

语法:
单行代码:代码之间分别用一个反引号包起来

    `代码内容`

代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

(```)
  代码...
  代码...
  代码...
(```)

注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。

示例:

单行代码

`create database hero;`

代码块

(```)
    function fun(){
         echo "这是一句非常牛逼的代码";
    }
    fun();
(```)

效果如下:

单行代码
create database hero;

代码块

function fun(){
  echo "这是一句非常牛逼的代码";
}
fun();

图片

语法:

![图片alt](图片地址 "图片title")

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

示例:

![blockchain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/
u=702257389,1274025419&fm=27&gp=0.jpg "区块链")

效果如下:

梦回蓝天的博客

超链接

语法:

[超链接名](超链接地址 "超链接title")
title可加可不加

示例:

[百度](http://baidu.com)

效果如下:

百度open in new window

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。 语法:

<邮箱地址或者普通链接>

示例:

<huangyan200918@163.com>
<http://baidu.com>

效果如下:

huangyan200918@163.com
http://baidu.comopen in new window

Last Updated:
Contributors: huangyanfu