Markdown语法入门

更新时间: 2017-03-29 17:23
当前版本: v0.0.2

1 标题

标题是每篇文章都有,也是最常用的格式。在Markdown语法中,标题使用井号#)开头,独占一行,后面添加一个空格分隔,之后的内容即为标题文本。

# 一级标题
## 二级标题
### 三级标题
...

以此类推,总共支持6级标题。

段落和换行

一个Markdown段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行

2 列表

在Markdown中,列表的显示只需要在文字前加上减号-)或者星号*)即可变为无序列表;如果在文字之前直接加上(数字+点),例如1.2.3.等。

注意:符号和列表文字之间也需要加上一个空格分割。

3 引用

如果你需要引用一小段别处的句子,那么可以使用引用格式。在Markdown中,只需要在段落的第一行最前面加上大于号(>),后面跟上你需要引用的文本即可,格式如下:

> 日出江花红胜火,春来江水绿如蓝。

显示效果如下:

日出江花红胜火,春来江水绿如蓝。

问题:如何在引用的内容中使用换行?

方法:在上一行文本的末尾添加两个空格再回车。

嵌套引用

引用是可以嵌套的,只需要根据层次加上不同数量的大于号(>),例如:

> 这是第一层引用开头
> >这是第二层引用开头  
> 
> 这是第一层引用结尾

运行效果如下:

这是第一层引用开头

这是第二层引用开头

这是第一层引用结尾

4 图片与链接

插入图片和插入链接的语法格式非常相似,区别在于插入图片时开头多了一个感叹号(!)。

插入图片

![](image_url)

注意:插入图片地址时需要图床,也就是需要一个存放图片的位置,并生成对应的URL。

插入链接

[link_display_name](link_url)

5 粗体和斜体

在Markdown中,可以使用文本前后各两个星号(*)或者下划线(_)来粗体表示星号中间的文字;使用文本前后各一个星号来斜体表示星号中间的文字。格式如下:

** 这是粗体 **
* 这是斜体 *

6 表格

在Markdown语法中,表示表格十分麻烦,示例如下:

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

其中,第一行用于设置表格的头部,列与列之间使用单竖线(|)分隔。第二行用于设置每一列的对齐方式,默认为左对齐,如果短横线两边各有一个冒号(:)就是居中对齐;否则,哪边有,就跟哪边对齐。效果如下:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

7 代码框

对于程序员而言,经常需要在文章中引用一段代码,这个时候就需要使用到代码框。在Markdown中,只需要使用前后各3个反引号(```)把代码片段包裹在中间即可。如果需要引用的代码只有一行,那么可以使用前后各1个反引号(`)把代码包裹起来。

```
import math
print math.PI
```

以上代码的运行效果如下:

import math
print math.PI

注意:可以使用TAB键进行缩进。

8 分割线

在Markdown中,三个连续的星号(*)可以生成一根分割线。运行效果如下:


9 反斜杠

Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果,你可以在星号的前面加上反斜杠:

\*不使用斜体,仅仅在两端使用星号强调*

*不使用斜体,仅仅在两端使用星号强调*

参考资料

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Markdown作为一种使用普通文本编辑器编写的标记语言,通过简单的标记语法,设置文本不同的格式。以实现 [易读易...
    Burjal阅读 1,791评论 3 23
  • 标题 Markdown支持两种标题的语法,类Setext和类atx形式。 类Setext 使用底线的形式,利用 =...
    禾边的晓作坊阅读 756评论 0 5
  • Markdown火了貌似好一阵子了,但一直以来都没有时间好好学习下它的语法。这是我用Markdown写的第一篇文章...
    SpaceCat阅读 2,213评论 0 2