Markdown简要学习笔记

---

认识 Markdown

Markdown 是一种用来写作的轻量级「标记语言」，它用简洁的语法代替排版，而不像一般我们用的字处理软件Word或Pages有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。目前来看，支持 Markdown 语法的编辑器有很多，包括很多网站（例如)也支持了 Markdown 的文字录入。Markdown 从写作到完成，导出格式随心所欲，你可以导出 HTML 格式的文件用来网站发布，也可以十分方便的导出 PDF 格式，这种格式写出的简历更能得到 HR 的好感。甚至可以利用CloudApp这种云服务工具直接上传至网页用来分享你的文章，全球最大的轻博客平台 Tumblr，也支持使用 Mou 这类 Markdown 工具进行编辑并直接上传。（[参考文章][2]）

Markdown 官方文档

• * 创始人 John Gruber 的 Markdown 语法说明 *
• * Markdown 中文版语法说明 *

使用 Markdown 的优点

• 专注你的文字内容而不是排版样式。

• 轻松的导出 HTML、PDF 和本身的 .md 文件。

• 纯文本内容，兼容所有的文本编辑器与字处理软件。

• 可读，直观。适合所有人的写作语言。

---

Markdown 语法的简要规则

标题

标题是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定义为标题，只要在这段文字前加#号即可。

标识写法：

# 一级标题
## 二级标题
### 三级标题

显示效果：

一级标题

二级标题

三级标题

四级标题

以此类推，总共六级标题，建议在井号后加一个空格，这是最标准的 Markdown 语法。

列表

熟悉 HTML 的同学肯定知道有序列表与无序列表的区别，在Markdown 下，列表的显示只需要在文字前加上+ 、- 或 * 即可变为无序列表，有序列表则直接在文字前加 1. 2. 3. 符号要和文字之间加上一个字符的空格。

无序列表标识写法：

+ 无序列表项1
+ 无序列表项2
- 无序列表项3
- 无序列表项4
* 无序列表项5
* 无序列表项6

显示效果：

• 无序列表项1
• 无序列表项2

• 无序列表项3
• 无序列表项4

• 无序列表项5
• 无序列表项6

有序列表标识写法：

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

显示效果：

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

引用

如果你需要引用一小段别处的句子，那么就要用引用的格式。只需要在文本前加入 > 这种尖括号（大于号）即可。

标识写法：

> 例如这样 

显示效果：

例如这样

图片与链接

插入链接与插入图片的语法很像，区别在一个 !号
插入图片的地址需要图床，这里推荐 SM.MS 的服务，生成URL地址即可。

插入图片标识写法：

![我的图片](https://ooo.0o0.ooo/2017/04/01/58df6f5c022ee.jpg)

显示效果：

[图片上传失败...(image-551682-1549084778488)]

插入链接标识写法（比插入图片少一个!）：

[我的](http://www.jianshu.com/u/2a7d78f9751c)

显示效果：

我的

粗体与斜体

Markdown 的粗体和斜体也非常简单，用两个 * 包含一段文本就是粗体的语法，用一个 * 包含一段文本就是斜体的语法。
标识写法：

**这里是粗体**  *这里是斜体*

显示效果：

这里是粗体 这里是斜体

---

表格

用 '|' 表示单元格分隔，用 '-----'表示上面一行是表头，用'-----:'表示'靠右'，用':----:'表示'居中'。

• 标识写法 *：

 | Tables        | Are           | Cool  |
 | ------------- |:-------------:| -----:|
 | col 3 is      | right-aligned | $1600 |
 | col 2 is      | centered      |   $12 |
 | zebra stripes | are neat      |    $1 |

显示效果：

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12
zebra stripes are	neat	$1

项目	价格	数量
计算机	$1600	5
手机	$12	12
管线	$1	234
管线	$1	234
管线	$1	234

代码框 [^code]

如果你是个程序猿，需要在文章里优雅的引用代码框，在 Markdown下实现也非常简单，只需要用两个```把中间的代码包裹起来。

标识写法：
```
public class Test()
{
System.out.println("hello world!");
}
```

显示效果：

public class Test()
{
System.out.println("hello world!");
}

---

作者博客： [@chenjf][1]     
2017 年 04月 08日    

[1]: http://weibo.com/chenjf

[2]: https://sspai.com/post/25137

[^code]: 代码高亮功能支持包括 Java, Python, JavaScript 在内的，**四十一**种主流编程语言。