markdown语法

2018-01-14 本文已影响0人紫英真人

1、标题

在文本前面加上 # 即可，总共六级：

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

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

注：# 和「一级标题」之间建议保留一个字符的空格，这是最标准的 Markdown 写法。

2、粗体/斜体

2.1 粗体

用两个 * 或两个_包含一段文本就是粗体的语法

**简书**、__简书__

简书、简书

2.2 斜体

用一个 * 或_包含一段文本就是斜体的语法

*一盏灯* 、_一盏灯_

一盏灯、一盏灯

2.3 粗斜体

***粗斜体***、___粗斜体___
_**粗斜体**_、*__粗斜体__*
**_粗斜体_**、__*粗斜体*__

粗斜体、粗斜体
粗斜体、粗斜体
粗斜体、粗斜体

2.4 删除线

用两个 ~包含一段文本就是删除线的语法

~~删除线~~

~~删除线~~

3、字体/颜色

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过类似HTML的标记语法，它可以使普通文本内容具有一定的格式。但是它本身是不支持修改字体、字号与颜色等功能的！
有一些Markdown编辑器带有内嵌HTML，可以用内嵌HTML实现修改字体、字号、颜色等功能。

4、列表

4.1 无序列表

无序列表使用星号、加号或是减号作为列表标记：

* Red
+ Green
- Blue

Green

Blue

在嵌套列表中可以循环使用。

- Item-1
  - Item-1-1
    + Item-1-1-1
      * Item-1-1-1-1
  * Item-1-2
+ Item-2
* Item-3

Item-1
- Item-1-1
  - Item-1-1-1
    - Item-1-1-1-1
- Item-1-2

Item-2

Item-3

4.2 有序列表

在文字前面加上 1. 2. 3. 例如：

1. 文本1
2. 文本2
3. 文本3

文本1
文本2
文本3

注：-、1.和文本之间要保留一个字符的空格。
数字不能省略但可无序（会自动按顺序补齐），点号之后的空格不能少。建立多级列表时，每个子级别都要比上个级别前面多打2个以上空格。

1. Item-1
 1.1. Item-1-1
    1.1.1. Item-1-1-1
      1.1.1.1. Item-1-1-1-1
  1.2. Item-1-2
2. Item-2
6. Item-3

Item-1
1.1. Item-1-1
1.1.1. Item-1-1-1
1.1.1.1. Item-1-1-1-1
1.2. Item-1-2
Item-2
Item-3

列表嵌套：

1. 列出所有元素：
    - 无序列表元素 A
        1. 元素 A 的有序子列表
    - 前面加四个空格
2. 列表里的多段换行：
    前面必须加四个空格，
    这样换行，整体的格式不会乱
3. 列表里引用：

    > 前面空一行
    > 仍然需要在 >  前面加四个空格

4. 列表里代码段：

    ```
    前面四个空格，之后按代码语法 ``` 书写
    ```

        或者直接空八个，引入代码块

列出所有元素：
- 无序列表元素 A
  1. 元素 A 的有序子列表
- 前面加四个空格
列表里的多段换行：
前面必须加四个空格，
这样换行，整体的格式不会乱
列表里引用：

前面空一行
仍然需要在 > 前面加四个空格

列表里代码段：

前面四个空格，之后按代码语法 ``` 书写

 或者直接空八个，引入代码块

5、超链接

5.1 行内式/内联（Inline）

语法：[显示文本](链接地址)
语法说明：
[]里写链接文字，()里写链接地址, ()中的" "(英文双引号)中可以为链接指定title属性，title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。[链接文字](链接地址 “链接标题”)’这样的形式。链接地址与链接标题前有一个空格。
示例1：[简书](http://www.jianshu.com)
简书
示例2：[简书](http://www.jianshu.com "简书")
简书

5.2 参考式/引用（Reference）

参考式超链接一般用在学术论文上面，或者另一种情况，如果某一个链接在文章中多处使用，那么使用引用的方式创建链接将非常好，它可以让你对链接进行统一的管理。通常分为两个部分：
调用部分格式为： [链接文字][链接标记]
*注：两个中括号之间可以有空格。
定义部分可以出现在文本中的其他位置，格式为：[链接标记]:链接地址 “链接标题”。
注：[链接标记]中不区分大小写。
示例：

我经常去的几个网站[Google][1]、[Leanote][2]以及[自己的博客][3]
[Leanote 笔记][2]是一个不错的[网站][]。

[1]:http://www.google.com "Google"
[2]:http://www.leanote.com "Leanote"
[3]:http://http://blog.leanote.com/freewalk "梵居闹市"
[网站]:http://http://blog.leanote.com/freewalk

我经常去的几个网站Google、Leanote以及自己的博客
 Leanote 笔记是一个不错的网站。

5.3自动链接

语法说明：
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用<>包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：

<http://www.baidu.com/>
<address@example.com>

http://www.baidu.com/
address@example.com

5.4 图片链接

图片的创建方式与超链接相似
语法中图片Alt的意思是如果图片因为某些原因不能显示，就用定义的图片Alt文字来代替图片。图片Title则和链接中的Title一样，表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的，可以省略，但建议写上。

5.4.1 行内式

语法说明：![图片Alt](图片地址 “图片Title”)
示例：
![](https://img.haomeiwen.com/i259/0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![美丽花儿](http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿")

美丽花儿

5.4.2 参考式

语法说明：
在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 “Title”
示例：

![美丽花儿][flower]

[flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg  "美丽的花朵"

捕获.PNG

import os
import cv2


def test1():
    video_root = r'E:\data_input\video_test'
    video_names = os.listdir(video_root)
    for video_name in video_names:
        video_path = os.path.join(video_root, video_name)
        cap = cv2.VideoCapture(video_path)
        ret, img = cap.read()
        print (ret)
        print (img)


def main():
    test1()

7、表格

语法说明：
不管是哪种方式，第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。
列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
第二行还可以为不同的列指定对齐方向。默认为左对齐，在-右边加上:就右对齐。

|、-、:之间的多余空格会被忽略，不影响布局。
-:表示内容和标题栏居右对齐，:-表示内容和标题栏居左对齐，:-:表示内容和标题栏居中对齐。
内容和|之间的多余空格会被忽略，每行第一个|和最后一个|可以省略，-的数量至少有一个。

示例1：简单方式

学号|姓名|分数
-|-|-
小明|男|75
小红|女|79
小陆|男|92

学号	姓名	分数
小明	男	75
小红	女	79
小陆	男	92

示例2：原生方式

|学号|姓名|分数|
|-|-|-|
|小明|男|75|
|小红|女|79|
|小陆|男|92|

学号	姓名	分数
小明	男	75
小红	女	79
小陆	男	92

示例3：右对齐/中间对齐方式

学号|姓名|分数
-|:-:|-:
小明|男|75
小红|女|79
小陆|男|92

学号	姓名	分数
小明	男	75
小红	女	79
小陆	男	92

8、上下标

简书中：

嘿嘿<sup>上标文字</sup>
嘿嘿<sub>下标文字</sub>

嘿嘿^上标文字
嘿嘿_下标文字
Typora中：

嘿嘿^上标文字^
嘿嘿~下标文字~

嘿嘿^上标文字
嘿嘿_下标文字

9、分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

***
* * *
_____
_ _ _ _ _
*****
- - -
---------------------------------------

10、引用

10.1 普通引用

在我们写作的时候经常需要引用他人的文字，这个时候引用这个格式就很有必要了，在 Markdown 中，你只需要在你希望引用的文字前面加上 > 就好了，例如：

> 一盏灯， 一片昏黄； 一简书， 一杯淡茶。 守着那一份淡定， 品读属于自己的寂寞。 保持淡定， 才能欣赏到最美丽的风景！ 保持淡定， 人生从此不再寂寞。

一盏灯，一片昏黄；一简书，一杯淡茶。守着那一份淡定，品读属于自己的寂寞。保持淡定，才能欣赏到最美丽的风景！保持淡定，人生从此不再寂寞。

注：> 和文本之间要保留一个字符的空格。折行可以不加，新起一行都要加上。

10.2 引用里嵌套引用

区块引用可以嵌套，只要根据层次加上不同数量的>：

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

这是第一级引用。

这是第二级引用。

现在回到第一级引用。

10.3 引用里嵌套列表

> - 这是引用里嵌套的一个列表
> - 还可以有子列表
>     * 子列表需要从 - 之后延后四个空格开始

这是引用里嵌套的一个列表

还可以有子列表

子列表需要从 - 之后延后四个空格开始

10.4 引用里嵌套代码块

>     同样的，在前面加四个空格形成代码块
>  
> ```
> 或者使用 ``` 形成代码块
> ```

同样的，在前面加四个空格形成代码块

或者使用 ``` 形成代码块

10.5 引用里嵌套其他

引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：

> ## 这是一个标题。
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec(`echo $input | $markdown_script`);

这是一个标题。

这是第一行列表项。

这是第二行列表项。

给出一些例子代码：

return shell_exec(echo $input | $markdown_script);

10.6 列表里嵌套引用

如果要在列表项目内放进引用，那>就需要缩进(tab或两个以上空格)：

* Coding.net有以下主要功能:
  > 代码托管平台
> 在线运行环境    
> 代码质量监控    
> 项目管理平台

Coding.net有以下主要功能:

代码托管平台
在线运行环境
代码质量监控
项目管理平台

注：

如果>、>>和>>>等嵌套使用的话，从>>>退到>时，必须之间要加上一个空行作为过渡，否则默认为下一行和上一行是同一级别的引用。
引用完之后，必须再空一行，重新一个新的开始，否则，以后的文字都将在引用的范围内。

11、注脚

语法说明：
在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。然后在文本的任意位置(一般在最后)添加脚注，脚注前必须有对应的脚注名字。
注意：经测试注脚与注脚之间必须空一行，不然会失效。成功后会发现，即使你没有把注脚写在文末，经Markdown转换后，也会自动归类到文章的最后。

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。

[^1]:Markdown是一种纯文本标记语言

[^2]:HyperText Markup Language 超文本标记语言

[^Le]:开源笔记平台，支持Markdown和笔记直接发为博文

使用 Markdown^[1]可以效率的书写文档, 直接转换成 HTML^[2], 你可以使用 Leanote^[3] 编辑器进行书写。

12、转义符

Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号:

\\   反斜线
\`   反引号
\*   星号
\_   底线
\{}  花括号
\[]  方括号
\()  括弧
\#   井字号
\+   加号
\-   减号
\.   英文句点
\!   惊叹号

\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号

Markdown是一种纯文本标记语言 ↩
HyperText Markup Language 超文本标记语言 ↩
开源笔记平台，支持Markdown和笔记直接发为博文 ↩