Markdown 简明教程

1. 斜体和粗体

语法说明:

*斜体* 或者 _斜体_
**粗体**
***加粗斜体

显示效果:

  • 这是斜体
  • 这是粗体
  • 这是加粗斜体

2. 标题

语法说明:

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

3. 段落与换行

语法说明:

无间隔换行: 在段落末加2个空格[Space][Space]
有间隔换行: 在段落后加2个换行[tr][tr]

显示效果:

第一行
第二行

第一行

第二行

4. 超链接

4.1. 自动链接

语法说明:

<http://o1zys.github.io/>

显示效果:

http://o1zys.github.io/

4.2. 行内式

语法说明:

[ ]里写链接文字,( )里写链接地址, ( )中的” “中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。[链接文字](链接地址 “链接标题”)’这样的形式。链接地址与链接标题前有一个空格。

[Oizys's Blog](http://o1zys.github.io/ "Oizys's Blog")

显示效果:

Oizys’s Blog

4.3. 参考式

语法说明:

参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。

参考式链接分为两部分,文中的写法 [链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题前有一个空格。

经常浏览[Google][1]以及[自己的博客][2]。
[Google][1]是很好的搜索网站。
[1]:http://www.google.com "Google"
[2]:http://o1zys.github.com "Oizys's Blog"

显示效果:

经常浏览Google以及自己的博客
Google是很好的搜索网站。

5. 列表

5.1. 无序列表

语法说明:

使用 *,+,- 表示无序列表。

- 无序列表项 一
+ 无序列表项 二
* 无序列表项 三

显示效果:

  • 无序列表项 一
  • 无序列表项 二
  • 无序列表项 三

5.2. 有序列表

语法说明:

使用数字表示有序列表。

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

显示效果:

  1. 有序列表项 一
  2. 有序列表项 二
  3. 有序列表项 三

5.3. 特殊情况

在特殊情况下,项目列表很可能会不小心产生,像是下面这样的写法:

1986. What a great season.

会显示成

  1. What a great season.

所以应该要改成

1986\. What a great season.

结果才会正确

1986. What a great season.

6. 引用

6.1 两种引用方式

语法说明:

> 这是一个有两段文字的引用,  
> 段落1句1.  
> 段落1句2.  
> 
> 段落2句3.  
> 段落2句4.  

显示效果:

这是一个有两段文字的引用,
段落1句1.
段落1句2.

段落2句3.
段落2句4.

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

语法说明:

> 这是一个有两段文字的引用,  
段落1句1.  
段落1句2.  

> 段落2句3.  
段落2句4.  

显示效果:

这是一个有两段文字的引用,
段落1句1.
段落1句2.

段落2句3.
段落2句4.

6.2. 引用的多层嵌套

语法说明:

> 第一级
> > 第二级
> > > 第三级

> > 二级

> 一级

显示效果:

第一级

第二级

第三级

二级

一级

7. 图像

7.1. 行内式

语法说明:

![图片Alt](图片地址 “图片Title”)

![头像](https://avatars.githubusercontent.com/o1zys
 "Oizys")

显示效果:

头像

7.2. 参考式

语法说明:

在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 “Title”

![头像][prof_pic]
[prof_pic]:https://avatars.githubusercontent.com/o1zys
 "Oizys"

显示效果:

头像

8. 代码

8.1. 行内式

语法说明:

学习一门新语言的开始是`HelloWorld()`。

显示效果:

学习一门新语言的开始是HelloWorld()

8.2. 缩进式多行代码

语法说明:

缩进 4 个空格或是 1 个制表符。
一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。

#include <iostream>
int main() {
    cout << "Hello World!" << endl;
}

显示效果:

#include <iostream>
int main() {
    cout << "Hello World!" << endl;
}

8.3. ``` 块

语法说明:

这种方式的代码块可以支持不同语言的语法高亮,要在 ``` 之后加上语言类型。

``` c++
#include
int main() {
cout << “Hello World!” << endl;
}
```

显示效果:

1
2
3
4
#include <iostream>
int main() {
cout << "Hello World!" << endl;
}

8.4. HTML原始码

语法说明:

在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,剩下的 Markdown 都会帮你处理,例如:

<table>
       <tr>
           <th rowspan="2">值班人员</th>
            <th>星期一</th>
            <th>星期二</th>
            <th>星期三</th>
        </tr>
    <tr>
        <td>张三</td>
        <td>李四</td>
        <td>王五</td>
    </tr>
</table>

显示效果:













值班人员 星期一 星期二 星期三
张三 李四 王五

9. 表格

语法说明:

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

简单方式:

姓名|性别|总分
-|-|-
小明|男|80
小红|女|130
小刚|男|9

原生方式:

|姓名|姓别|总分|
|-|-|-|
|小明|男|80|
|小红|女|130|
|小刚|男|9|

为第三列指定右对齐:

姓名|性别|总分
-|-|-:
小明|男|80
小红|女|130
小刚|男|9

显示效果:

简单方式:

姓名 性别 总分
小明 80
小红 130
小刚 9

原生方式:

姓名 姓别 总分
小明 80
小红 130
小刚 9

为第三列指定右对齐:

姓名 性别 总分
小明 80
小红 130
小刚 9

10. 内容目录

在段落中填写[TOC]以显示全文内容的目录结构。

11. 注脚

语法说明:

在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。

注意:经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经Markdown转换后,也会自动归类到文章的最后。

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2]

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

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

显示效果:

使用 Markdown^1可以效率的书写文档, 直接转换成 HTML[^2]。

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

注:脚注自动被搬运到最后面,请到文章末尾查看,并且脚注后方的链接可以直接跳转回到加注的地方。

12. LaTex公式

这里采用MathJax引擎,所以在Markdown文件中必须添加

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>

12.1. $表示行内公式

语法说明:

质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。

显示效果:
质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。

12.2. $$表示整行公式

语法说明:

$$\sum_{i=1}^n a_i=0$$  

$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2$$  

显示效果:

$$\sum_{i=1}^n a_i=0$$

$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2$$

访问 MathJax 参考更多使用方法。

13. 分隔线

语法说明:

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

* * *

***

*****

- - -

---------------------------------------

显示效果: