Markdown语法介绍

前言

最近准备开始写博客,整理自己学习的技术知识。但手动调整博客的文本格式实在太不美观和geek,因而选择Markdown排版博客内容。Markdown是一种轻量级标记语言,且兼容HTML。可通过标记符号设置文本格式,让作者专注于写作内容,当前的主流博客网站和GitHub版块多采用Markdown。

Markdown将格式对象主要分为区块元素区段元素两部分。区块元素主要包括段落换行标题区块引用列表分割线;区段元素包括强调链接图片代码块

区块元素

段落和换行

Markdown中段落是由一个或多个连续的本文组成,段落前后应该有1个以上的空行,单独的换行符不会实现段落换行。如果不想插入空行进行换行,可以在换行符前插入2个以上的空格来实现段落换行。例如:

第一段

第二段

第一段(两空格)
第二段

标题

在标题文本前使用“#”,并用空格分割可以创建一级标题。如果需要创建多级标题,可使用不同数量的“#”,最多可创建6级标题。如下所示:

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

区块引用

Markdown标记区块引用时,在每行的开头添加符号">"或在每段的第一行开头添加">",如下所示:

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
>Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

效果如下:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

另外区块引用允许多级嵌套,只需根据层次添加不同数量的">"。例如:

> 这是第一级引用。
>
> > 这是第二级引用。
>
> 现在回到第一级引用。

效果如下

这是第一级引用。

这是第二级引用。

现在回到第一级引用。

列表

Markdown支持有序列表和无序列表。

无序列表使用“*”,"+"和"-"作为记号,通常放在最左侧,记号与文本间用空格分割。

* 列表1
* 列表2
* 列表3

效果如下

  • 列表1
  • 列表2
  • 列表3

有序列表使用数字加英文句号作为记号,记号与文本间用空格分割,且有序列表的序号与记号中的数字无关。例如以下两组列表,生成的列表序号相同。

1. 列表1
2. 列表2
3. 列表3

1. 列表1
1. 列表2
1. 列表3

效果如下

  1. 列表1
  2. 列表2
  3. 列表3

如果需要在列表中加入区块引用或代码块,则整个区块或代码块需整体缩进4个空格或一个制表符,例如:

* 列表1
        > 引用内容

效果如下所示

  • 列表1

    引用内容

分割线

在单独的一行中使用三个以上的星号"*",减号“-”或底线"_"来创建分割线,且行内不能再有其他内容。

___
***
---

效果如下


区段元素

强调

强调包括斜体加粗两种方式。

斜体使用一对“*”包裹需要强调的文字,例如:

*斜体*

其效果为:斜体

加粗使用一对“**”包裹需要强调的文字,例如:

**加粗**

其效果为:加粗

代码块

标记代码块的方式有两种。一种是通过缩进4个空格或1个制表符进行标记;更常用的方法是使用反引号将代码块包裹起来,避免无休止的缩进。该方法可指定语言标识,对标记的代码块启用语法着色。例如:

```python
import sys
img_list_in = open(sys.argv[1])
```

效果如下:

import sys
img_list_in = open(sys.argv[1])

链接

Markdown支持两种链接的表示方式:内联式引用式

内联式的表示形式为 [text] (URL)。其中,[]中的内容是链接文字,()中的内容是链接地址。例如:

This is [GitHub] (https://www.github.com) link.

效果如下
This is GitHub link.

引用式的表示方式为

[text] [id]

[id]: URL

例如:

This is [GitHub] [github] link.

[github]: https://www.github.com

效果如下:
This is GitHub github link.

插入图片

Markdown使用与链接相似的语法来插入图片,也可分为内联式和引用式。

内联式插入图片的语法为:

![text] (URL)

引用式插入图片的语法为:

![text] [id]

[id]: URL

例如:

![CR7](http://bestsportsshots.com/wp-content/uploads/2018/01/cr7-power.jpg)

![CR7] [player]

[player]: http://bestsportsshots.com/wp-content/uploads/2018/01/cr7-power.jpg

效果如下
CR7

需要注意的是,Markdown无法指定插入图片的宽高。如果需要,可以使用 <img>标签。

posted @ 2018-05-01 22:27  尺墨轩志  阅读(266)  评论(0编辑  收藏  举报