markdown语法

本文

主要介绍了markdown基本语法。

版本 说明
0.1 初版发布

背景

  • 主机: Thinkpad S2
  • 系统: Deepin GNU/Linux 15.11
  • 内核: Debian 6.3.0-18+deb9u1

什么是markdown?

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。可能听起来有些抽象,简单来说就是纯文本编辑方式,依据特殊语法,经过工具渲染,可以达到很漂亮的显示效果,除此之外还能支持更多复杂功能,比如数学符号的显示等等。

Markdown的语法简洁明了、学习容易,而且功能比纯文本更强,因此很多博客平台都支持markdown,比如简书和CSDN,对markdown都有很好的支持,有些网站的评论窗口也支持markdown。目前markdown因为简单易用的特点,已经被广泛使用。不过各平台对markdown的支持情况也不太统一,所以存在部分兼容问题,不过不用担心,常用语法还是一致的。

语法介绍

标题

注意,中间有空格。

1
2
3
4
5
6
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

字体

  • 加粗:将要加粗的文字左右分别用**号包起来,如“**粗体**” (好像用下划线包起来也可以,如“__粗体__”)
  • 斜体:将要倾斜的文字左右分别用*号包起来,如“*斜体*” (好像用下划线包起来也可以,如“_斜体_”)
  • 斜体加粗:将要倾斜和加粗的文字左右分别用三个*号包起来,如“***粗斜体***” (好像用下划线包起来也可以,如“___粗斜体___”)
  • 删除线:将要加删除线的文字左右分别用两个~~号包起来,如“删除线
  • 高亮:将要加高亮的文字左右分别用两个==号包起来,如“==高亮==”

分割线

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

1
---

图片

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

1
![图片名称](图片网址 ''图片标题'')

当然也可以使用html格式,这里添加了对图片的大小和显示位置做了控制,如下:

1
2
3
4
<center>
<img width="800" src="图片地址">
<div style="color:black;"> <b>  </b>  </div>
</center>

超链接

title可不加

1
2
[超链接名](超链接地址 "超链接title")
[百度](http://baidu.com)

列表

  • 无序列表(注意,符号与内容间有空格)
1
2
- 列表内容
+ 列表内容
  • 有序列表(注意,符号与内容间有空格)
1
2
1. 列表内容
2. 列表内容
  • 列表嵌套
1
2
3
4
- 一级无序列表内容
   1. 二级有序列表内容
   2. 二级有序列表内容
   3. 二级有序列表内容

表格

第二行分割表头和内容,其中“-”有一个就行,也可以为了对齐多加几个;文字默认左对齐,“-”两边加“:”表示文字居中,"-“右边加“:”表示文字右对齐。注意,符号为英文符号。

1
2
3
4
|表头|表头|表头|
|---|:--:|---:|
|内容|内容|内容|
|内容|内容|内容|

代码

  • 单行代码,代码之间分别用一个反引号包起来
1
`代码内容`
  • 多行代码,代码之间分别用三个反引号包起来
1
2
3
4
5
```
代码...
代码...
代码...
```

段落、换行、缩进

Markdown语法中,两个段落之间是用空白行分隔的,如果作为两个段落,编辑时请在中间加空白行,不过中间加即时多个空白行却只显示一个空白行,如果想加多个空白行,就要借助html的换行命令,如下;如果想首行缩进,需要输入全角空格,不过不建议使用,markdown是用空白行来区分段落的,而不是缩进。

1
<br>

文章原创,可能存在部分错误,欢迎指正,联系邮箱 cao_arvin@163.com。