Day-1 - MarkDown语法（2018-09-25）

一.基础语法
- 1.设置标题
- 2.列表
- 3.引用
- 4.粗体和斜体
- 5.链接与图片
- 6.代码行
- 7.分割线
- 8.代码高亮
- 9.表格
- 10.删除
二.存在问题

一.基础语法

1.设置标题

在文本前添加“#”

例：

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

效果如下：

图1.1-标题设置效果.png

注：在“#”与文字之间添加一个空格，是最标准的MarkDown语法。

图片上传方法
将本地图片上传为网络图片（本地图片只能在本地查看）
将图片上传到“七牛云”网站 ->管理控制台->对象存储->内容管理->上传图片->操作预览->复制图片链接

2.列表

无序列表
文字前面加上“-”
- 例：

- 文本1
- 文本2
- 文本3

效果如下：
- 文本1
- 文本2
- 文本3

有序列表
文字面前加上“1.”、“2.”、“3.”
- 例：

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

效果如下：
1. 文本1
2. 文本2
3. 文本3

3.引用

1.引用的格式是使用“>”并在后面书写文字

例：

>引用的文本

效果如下：

引用的文本

2.多重引用

例：

>多重引用    
>- 一重引用
  >>多重引用
  >>- 二重引用
    >>>多重引用
    >>>- 三重引用

效果如下：
多重引用
- 一重引用
多重引用
- 二重引用
多重引用
- 三重引用

4.粗体和斜体

粗体：在需要加粗体的文字两端各加上两个“*”
斜体：在需要加斜体的文字两端各加上两个“*”
粗体和斜体：在需要加粗体和斜体的文字两端各加三个“*”
- 例：

 **这个是粗体**
 *这个是斜体*
 ***这个是粗体加斜体***

效果如下：
这个是粗体
这个是斜体
这个是粗体加斜体

5.链接与图片

1.1 文字链接（方法一）：“[]”中添加链接的文字，“()”中加入链接

例：

[link test](http://www.example.com/)

效果如下：
link name

1.2 文字链接（方法二）：第一个“[]”中添加链接的文字，第二个“[]”中添加引用链接的id,之后再引用中，使用“[id]:链接”的格式

例：
效果如下：
[link text][1]
[1]: http://example.com,"我是标题"

2.直接引用链接：“<>”中直接加入链接

例：

or

效果如下：
http://baidu.com or [email protected]

3.插入互联网图片：“！” + “[]”中加入图片描述 + “()”中加入图片链接

例：

![插入互联网图片效果.png](https://upload-images.jianshu.io/upload_images/14187449-d4f1b22dd88b7a82.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果如下：

插入互联网图片效果.png

6.代码行

用“Tab”键起始的行会设置为代码行（上需要加2个“tab”,并用两个回车和上一行隔开）：

例：

图6.1-代码行语法（蓝色为空格）.png
效果如下：

print ("hello world")

在行内引用代码，用反引号“`”：

例：

please print your name like this: `print ("name")`

效果如下：
please print your name like this: print ("name")

7.分割线

在一行用三个以上的“-”或者“*”或者“_”来建立分割线

例：

---
*****
______

效果如下：

8.代码高亮

在需要高亮的代码行的前一行以及后一行使用三个反引号“```”，在第一行反引号后面写明使用的语言

例：

```python
 class RandomWalk():
"""一个生产随机漫步数据的类"""

def __init__(self,num_points=5000):
    """初始化随机漫步的属性"""
    self.num_points = num_points
    """所有点都起始于（0,0）"""
    self.x_values = [0]
    self.y_values = [0]
```

效果如下：

 class RandomWalk():
    """一个生产随机漫步数据的类"""
    
    def __init__(self,num_points=5000):
        """初始化随机漫步的属性"""
        self.num_points = num_points
        """所有点都起始于（0,0）"""
        self.x_values = [0]
        self.y_values = [0]

9.表格

使用“|”绘制表格，并且使用“:”来设置表格对齐格式

例：

| name        | age          | position |
| ------------- |:-------------:| -----:|
| James      | 34 | SF |
| Paul      | 33 | PG |
| Hardon | 27 | SG |

效果如下：

name	age	position
James	34	SF
Paul	33	PG
Hardon	27	SG

10.删除

~~此为错误~~

~~此为错误~~

二.存在问题

question	description
文字链接	无法用id关联链接，见5.1.2
生成目录	用Visual Studio Code + TCO扩展生成的目录在无法正确链接到内容

Visual Studio Code使用目录效果.png