Github Makedown 语法入门
GitHub上创建GitHub项目，会包含了一个 README.md 文件，此文件编辑就会用到Markdown
本文将详细介绍Markdown文件（md文件）的语法。
本文示例开源项目，请见GitHub：
https://github.com/mimvp/mimvp-markdown-syntax
1. 新建GitHub项目
文本以米扑科技的项目库为例：mimvp
新建项目链接：https://github.com/organizations/mimvp/repositories/new
2. 查看创建项目
3. 下载编辑 README.md
0） 克隆项目到本地
https://github.com/mimvp/mimvp-markdown-syntax.git
编辑好README.md文件后，再提交上传到GitHub，这种方式效率低。
推荐一种更快捷的编辑README.md方式，直接在Github上编辑（推荐）
a）点击 README.md文件
b）点击下图红框，直接编辑
1）Markdown 标题
markdown 支持两种标题的语法：Setext 和 atx 形式，两者也可以结合使用，效果更好！
a）Setext 形式
用底线的形式，利用 === （最高阶标题）和 ----- （第二阶标题）
Markdown 语法：
米扑科技 ======== 官网 [http://mimvp.com](http://mimvp.com) 官网 <a target="_blank" href="http://mimvp.com">http://mimvp.com</a> 米扑代理 -------- 官网 [http://proxy.mimvp.com](http://proxy.mimvp.com) 米扑域名 -------- 官网 <a target="_blank" href="http://domain.mimvp.com">http://domain.mimvp.com</a> 米扑财富 -------- 官网 <a href="http://money.mimvp.com" target="_blank">http://money.mimvp.com</a>
Markdown 结果：
b）atx 形式
用#号标识标题，最多六级标题（不支持七级、八级等标题，会直接显示出文字）
Markdown 语法：
标题示例 ======== # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
Markdown 结果：
2）Markdown 代码块
代码块，以大于号（>）开头。若末尾不加换行符<br/>，则所有文字会连接在一起不会换行。
Markdown 语法：
Markdown 代码块 ======== > 米扑科技，小而美，简而信，工匠艺术的互联网服务。 <br/> > 米扑团队，来自百度、小米、创新工场、阿里，核心研发，实战经验丰富。 <br/> > 米扑产品，已上线服务包括米扑代理、米扑域名、米扑支付、米扑财富、米扑博客等。 <br/> > 米扑科技官网： [mimvp.com](http://mimvp.com)
Markdown 结果：
3）Markdown 引用块
引用块，以特殊引号（`）开头。注意：不是单引号，而是特殊引号，在键盘左上角的“esc”左下方的那个按键
Markdown 语法：
Markdown 引用块 ======== 米扑科技简介 ``` 米扑科技，小而美，简而信，工匠艺术的互联网服务。 米扑团队，来自百度、小米、创新工场、阿里，核心研发，实战经验丰富。 米扑产品，已上线服务包括米扑代理、米扑域名、米扑支付、米扑财富、米扑博客等。 米扑科技官网： mimvp.com ```
Markdown 结果：
4）Markdown 代码高亮
代码高亮，以特殊引号（`）开头，并跟上代码语言，例如：python、java、javascript、ruby、perl、go、c、c++、bash等。
注意：不是单引号，而是特殊引号，在键盘左上角的“esc”左下方的那个按键
Markdown 语法:
Markdown 代码高亮
========
```python
#!/usr/bin/env python
# -*- coding:utf-8 -*-
if __name__ == "__main__":
echo "hello mimvp"
print("I love mimvp.com")
```
Markdown 结果：
5）Markdown 字体加粗
* 或 _，表示斜体
** 或 __，表示粗体
~~ 表示删除线
Markdown 语法:
Markdown 字体加粗 ======== 我爱 米扑科技 <br/> 我爱 *米扑科技* （斜体） <br/> 我爱 _米扑科技_ （斜体） <br/> 我爱 **米扑科技** （粗体） <br/> 我爱 __米扑科技__ （粗体） <br/> 我爱 ***米扑*科技** （斜体 + 粗体） <br/> 我爱 ~~米扑科技~~ （删除线） <br/>
Markdown 结果：
6）Markdown 无序列表
*（星号） +（加号） - （减号）表示无序列表
Markdown 语法:
Markdown 无序列表 ======== *（星号） -------- * 米扑科技 * 米扑代理 * 米扑域名 * 米扑财富 +（加号） -------- + 米扑科技 + 米扑代理 + 米扑域名 + 米扑财富 -（减号） -------- - 米扑科技 - 米扑代理 - 米扑域名 - 米扑财富
Markdown 结果：
7）Markdown 有序列表
直接用1. xxx 2. xxx 3. xxx 编辑
Markdown 语法:
Markdown 有序列表 ======== 1. 米扑科技 2. 米扑代理 3. 米扑域名 4. 米扑财富
Markdown 结果：
8）Markdown 插入链接
Markdown 插入链接，有两种方式：
方式1） [mimvp.com](http://mimvp.com)
方式2）<a target="_blank" href="http://mimvp.com">mimvp.com</a> （推荐）
Markdown 语法:
米扑科技 ======== 官网 [http://mimvp.com](http://mimvp.com) 官网 <a target="_blank" href="http://mimvp.com">http://mimvp.com</a> 米扑代理 -------- 官网 [http://proxy.mimvp.com](http://proxy.mimvp.com) 米扑域名 -------- 官网 <a target="_blank" href="http://domain.mimvp.com">http://domain.mimvp.com</a> 米扑财富 -------- 官网 <a href="http://money.mimvp.com" target="_blank">http://money.mimvp.com</a>
Markdown 结果：
9）Markdown 插入图片
Markdown 插入图片有两种方式：
方式1） 
方式2） <img src="./mimvp-logo.png" title="mimvp-logo.png" />
Markdown 语法:
Markdown 插入图片 ======== ### 1. 米扑科技（默认）  ### 2. 米扑科技（img） <img src="./mimvp-logo.png" title="mimvp-logo.png" />
Markdown 结果：
10）Markdown 表格
Makrdown 支持table表格，语法跟wiki类似。同时，也支持table标签
方式1
Markdown 语法:
Markdown 表格 ======== |产品|网址|年份| |----|-----|-----| |米扑代理|[proxy.mimvp.com](http://proxy.mimvp.com)|2014| |米扑域名|[domain.mimvp.com](http://domain.mimvp.com)|2015| |米扑支付|[pay.mimvp.com](http://pay.mimvp.com)|2016| |米扑财富|[money.mimvp.com](http://money.mimvp.com)|2017|
Markdown 结果：
方式2
Markdown 语法：
<table> <tr> <td colspan="3" color="red">米扑产品</td> </tr> <tr> <td>米扑代理</td> <td>http://proxy.mimvp.com</td> <td>2014</td> </tr> <tr> <td>米扑域名</td> <td>http://domain.mimvp.com</td> <td>2015</td> </tr> <tr> <td>米扑支付</td> <td>http://pay.mimvp.com</td> <td>2016</td> </tr> <tr> <td>米扑财富</td> <td>http://money.mimvp.com</td> <td>2017</td> </tr> </table>
Markdown 结果：
11）Markdown 多选项
多选项，结合了多种元素，如无序列表减号（-），方括号等
Markdown 语法:
Markdown 多选项 ======== 米扑产品包含？ - [x] 米扑代理 - [x] 米扑域名 - [x] 米扑支付 - [x] 米扑财富 - [ ] 米扑基金 - [ ] 米扑期货
Markdown 结果：
12）Markdown emoji表情
Markdown 语法:
Markdown emoji ======== @mimvp is :+1: This PR looks great - I love mimvp.com :smiley:
Markdown 结果：
13）Markdown diff 高亮对比
diff 语法是代码高亮语法的一种，以 `+ `开头表示新增，`- `开头表示删除。
Markdown 语法:
Markdown diff 高亮对比 ---------- ```diff + 增加 emoji.md - 删除 emoji.txt ```
Markdown 结果：
14）Markdown 其它知识
知识1： [回到顶部](#readme)
知识2： 版本符号 ©
Markdown 语法:
Markdown 其它知识 ---------- |`[回到顶部](#readme)`|[回到顶部](#readme)| |`版本符号 ©`|©|
Markdown 结果：
15）Markdown 版权格式
一般开源项目，末尾会追加一些开原作者的信息，例如米扑科技的作者信息如下，供参考。
Markdown 语法:
米扑科技 ---------- <img src="./mimvp-logo.png" title="mimvp-logo.png" /> All Right © [mimvp.com](http://mimvp.com) :blush:
Markdown 结果：
本文Markdown示例，请见米扑科技的 GitHub：
https://github.com/mimvp/mimvp-markdown-syntax
参考推荐：
版权所有: 本文系米扑博客原创、转载、摘录，或修订后发表，最后更新于 2017-08-09 22:00:01
侵权处理: 本个人博客，不盈利，若侵犯了您的作品权，请联系博主删除，莫恶意，索钱财，感谢！