Markdown总结与归纳

2018-01-03

字数统计: 1.6k字 | 阅读时长: 5分

最初只需要记住# 标题一、## 标题二、1. 第一点、* 这一点，用这几个写写日志、需求文档、小文章，排版上足够了；
逐渐的你发现有些文字需要重点指出，那么还可以使用加粗、斜体来对文字做重点说明；
如果你是名程序员，那么可以用 ``` 把代码块包起来，渲染后可以关键字高亮，用> 可以做引用。

Markdown常用标记

标题

在行首插入 1 到 6个#，分别表示标题 1 到标题 6

1
2
3

# 这是标题1
## 这是标题2
###### 这是标题6

这是标题1

这是标题6

有序列表

在行首增加 1.、2.、3.，即数字和英文句点, 注意句点与文字中间有空格。不要求数字一定要连续，可以都是1.

1
2
3

1. 有序列表
1. 有序列表
4. 有序列表

有序列表
有序列表
有序列表

无序列表

在行首增加 * 或 - 与文字之间有空格

1 2	* 无序列表 * 无序列表

无序列表
无序列表
注意
1 .无序列表或有序列表标记和后面的文字之间要有一个空格隔开。
2 .有序列表标记不是按照你写的数字进行显示的，而是根据当前有序列表标记所在位置显示的。
插入图片

使用

1	![Alt text](/img/罗宾2.jpg "Optional title")

导入图片。其中：
Alt text为如果图片无法显示时显示的文字；
/img/罗宾2.jpg为图片所在路径；
Optional title为显示标题。显示效果为在你将鼠标放到图片上后，会显示一个小框提示，提示的内容就是 Optional title里的内容。
效果

注意

导入的图片路径可以使用绝对路径也可以使用相对路径，建议使用相对路径。
我通常的做法是Markdown文档的同级目录下建立一个pictures文件夹，里面放置所有所需的图片，如果图片多的话，你也可以在pictures文件夹里建立子文件夹归类。

插入链接

使用[](link "Optional title")表示行内链接。其中：
[]内的内容为要添加链接的文字。
link为链接地址。
Optional title为显示标题。显示效果为在你将鼠标放到链接上后，会显示一个小框提示，提示的内容就是 Optional title里的内容。
参考式链接如例所示。

例1：行内链接

1	这就是我们常用的地址：[Baidu](www.baidu.com "百度一下，你就知道" )

这就是我们常用的地址：Baidu

例2：参考式链接

1
2
3

这就是我们常用的地址：[Baidu][1]
[1]:www.baidu.com "百度一下，你就知道"

这就是我们常用的地址：Baidu

注意

参考式链接和行内链接的显示效果是一样的，但是在编辑状态下的使用情况不一样。行内连接紧跟链接文字，可以在看到链接文字的同时清楚的知道链接地址，但是不便于多次重复利用。参考式链接可以重复使用，但一般都是将一些链接放在一起统一管理，如一段文字后面或文章结尾，因此在找到链接和链接文字的对应关系上有些麻烦。各有利弊了，分情况使用。

粗体、斜体、删除线

粗体：在文字前后添加 * (注意符号与文字间不要有空格）
斜体：在文字前后添加
删除线：在文字前后添加 ~~

1
2
3

**粗体**
*斜体*
~~删除线~~

粗体
斜体
~~删除线~~

引用

在文字前添加 >
使用>表示引用，>>表示引用里面再套一层引用，依次类推。

例1：

> 这是一级引用
>>这是二级引用
>>> 这是三级引用 
>这是一级引用

这是一级引用

这是二级引用

这是三级引用
这是一级引用

注意

如果>和>>嵌套使用的话，从>>退到>时，必须之间要加一个空格或者>作为过渡，否则默认为下一行和上一行是同一级别的引用。如示例所示。
引用标记里可以使用其他标记，如：有序列表或无序列表标记，代码标记等。

表格

|表头一|表头二|  
|------|---|
|内容一|内容二|
|内容三|内容四|

显示结果：

表头一	表头二
内容一	内容二
内容三	内容四

需要注意的是，第二行中的-只要有三个或三个以上即可。没有具体的个数要求。

带左中右对齐的表格。

|左对齐|居中对齐|右对齐|
|:-    |:------:|-:|
|左对齐列|居中对齐列|右对齐列|
|1|2|3|

左对齐	居中对齐	右对齐
左对齐列	居中对齐列	右对齐列
1	2	3

同样对于第二列中的空格数没有要求，但至少要有一个-。

代码

代码块

在代码前后增加三个反单引号：```

int i = 0; i = 1; 
for (int i = 0; i < 100; i++)
{
      printf("hello markdown!\n");
}

如果需要指定语言,在开头的```后紧跟具体语言，如:
```java。
` 这个符号是在Esc键下面，切换到英文下即可。

行内代码

使用``表示行内代码。
示例

1	这是`javascript`代码

这是javascript代码

分割线

使用---或者***或者* * *表示水平分割线。

示例

---
***
* * *

注意

只要* 或者-大于等于三个就可组成一条平行线。
使用---作为水平分割线时，要在它的前后都空一行，防止---被当成标题标记的表示方式。

Markdown常用标记

标题

这是标题1

这是标题1

这是标题6

有序列表

无序列表

注意

插入图片

注意

插入链接

注意

粗体、斜体、删除线

引用

注意

表格

代码

代码块

行内代码

分割线

注意

目录