学习使用Markdown

1 关于Markdown

Markdown是一种轻量级标记语言，它的目的是希望大家使用“易于阅读、易于撰写的纯文字格式，并选择性的转换成有效的HTML(或XHTML)”。

1. 优点

   • 易读

     易读是指Markdown文件（即 .md 文件）容易阅读，与HTML相比，它没有各种繁杂的尖括号<>和缩进。整体简洁美观。

   • 易写

     使用Markdown可以让你专注于文字，不用像office软件一样需要用鼠标疯狂点击那些排版按钮，可以做到手不离键盘且快速高效的将写作与排版一气呵成。而且Markdown语法简单，花半个小时就能学会基本语法。

2. 缺点

   • 标准不统一

     目前Markdown语法众多、编辑器层出不穷，每个编辑器支持的语法也不同，这就导致在一个编辑器上写的md文件，放到其它编辑器上，出现排版混乱，甚至是不支持某些语法的现象。这就是人们所说的 “方言现象”，这也是目前Markdown最突出的问题。

   • 图片支持不够

     不能直接显示图片，不能调整大小。且不同编辑器对图片的处理也有所不同。

   • 表格支持不够

     原生的Markdown是不支持表格的，但现在大部分编辑器都支持简单的表格，也有支持复杂表格的语法，但是书写困难，且不被大多数编辑器支持。

   • 占用特殊字符

     Markdown的语法占用了一些特殊字符，导致想在文本中输入特殊字符的时候，需要进行转义操作。

3. 使用群体

   • 喜欢写博客的人
   • 经常阅读书写各种技术文档的技术人员
   • 混迹于各种技术论坛和社区的程序员
   • 追求简洁排版、快速编辑的文字工作者

2 基本语法

2.1 标题

只需要在文本前面加上 # 号即可(注意#号后面有一个空格)，二级标题加两个 ## ，三级标题加三个 ### ，以此类推，最多六级标题。

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

2.2 列表

1. 无序列表

使用 *，+，- 表示无序列表。列表可以嵌套，上一级和下一级之间敲三个空格即可，建议相同级别的列表项使用相同的符号，并且保持缩进一致，如一级列表用 *，二级列表用 +，三级列表用 - 。 （注意后面需要加空格）

示例：

* 无序列表项1
   + 无序列表项1.1
      - 无序列表项1.1.1
   + 无序列表项1.2
      - 无序列表项1.2.1
* 无序列表项2
* 无序列表项3

效果如下：

• 无序列表项1
  • 无序列表项1.1
    • 无序列表项1.1.1
  • 无序列表项1.2
    • 无序列表项1.2.1
• 无序列表项2
• 无序列表项3

2. 有序列表

使用数字和点表示有序列表。（注意后面需要加空格）

示例：

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

效果如下：

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

2.3 字体

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

效果如下：

• 斜体
• 加粗
• 斜体加粗
• 删除线

2.4 引用

在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>，貌似可以一直嵌套下去。

> 引用
>> 引用
>>> 引用
>>>>>>>> 引用

效果如下：

引用

引用

引用

引用

2.5 分割线

使用三个或三个以上的 - 或 *。
示例：

---
--------
***
********

效果如下：

---

2.6 超链接

加入超链接的格式如下：

[链接名字](链接地址, "链接title")

其中链接title可以不填。
例如：

[百度一下](https://www.baidu.com/)

注意：不能直接写成 www.baidu.com ，需要加 https://或http://

效果如下，点击即可访问：
百度一下

2.7 插入图片

插入图片的格式如下：

![图片描述](图片地址)

其中图片title可以不填。
例如：

![tree](http://hru.com/blog/180910/84.jpg?imageim)

效果如下：

tree

2.8 表格

下面是一般表格的书写格式：

表头|表头|表头
---|---|---
内容|内容|内容
内容|内容|内容

表的两边可以加 | 将表包围起来，也可以不加，效果一样，如下所示：

|表头|表头|表头|
|---|---|---|
|内容|内容|内容|
|内容|内容|内容|

Markdown默认表的内容是左对齐，标题是居中对齐，我们可以根据需要，使用 : 来进行对齐。
示例：

左对齐|居中|右对齐
:---|:---:|---:
内容|内容|内容
内容|内容|内容

"-"短线每一栏加1个就够了，这里为了对齐，都加了3个。
左边加":"表示文字居左。
两边加":"表示文字居中。
右边加":"表示文字居右。

效果如下：

左对齐标题	居中标题	右对齐标题
内容	内容	内容
内容	内容	内容

2.9 代码

Markdown可以内嵌代码，还支持代码高亮，不同开发语言有不同的高亮形式。

语法如下：

单行代码使用两个 ` 将代码包围起来：

> `代码`

多行代码使用两个 ``` 加代码语言标识：

> (``` 语言标识)
> 代码块
> (```)

上面的括号和>不用写，这里为了方便展示多加了，请忽略

语言标识是对各种语言的分类，如：python，c，bash，java，php，sql......

效果如下：

单行代码： unsigned int a;

多行代码(语言标识：C)：

int main()
{
  int a = 9;
  printf("%d\n", a);
  return 0;
}

2.10 待办事宜 Todo 列表

使用带有 [ ] 或 [x] （未完成或已完成）项的列表语法撰写一个待办事宜列表，并且支持子列表嵌套以及混用Markdown语法，例如：

- [ ] 一级任务
    - [ ] 二级任务
    - [x] 二级任务
    - [x] 二级任务
        - [x] 三级任务
        - [x] 三级任务
- [ ] 一级任务
    - [ ] 二级任务

效果如下：

• [ ] 一级任务
  • [ ] 二级任务
  • [x] 二级任务
  • [x] 二级任务
    • [x] 三级任务
    • [x] 三级任务
• [ ] 一级任务
  • [ ] 二级任务

3、支持Markdown语法的软件或网站

编辑软件：

1. atom —— 21世纪黑客文本编辑器，里面有各种插件，程序猿专用软件，也是我目前在用的编辑软件。
2. Visual Studio Code —— 一心想要统治地球的软件，对Markdown语法要求严格，经常会出现红波浪线和绿波浪线。
3. MarkdownPad —— 一款全功能的编辑器，被很多人称赞为windows 平台最好用的markdown编辑器。
4. Sublime Text 2 —— 界面简约大方，定位专业。
5. Smark
6. MdCharm

网站（在线编辑器）：

1. —— 一个很好的博客平台，简约美观，写文章时可以直接拖入图片生成链接。
2. dillinger —— 支持md, html, pdf 文件导出。支持dropbox, onedrive，google drive, github.
3. Cmd Markdown
4. 小书匠编辑器

如果上面没有适合你的编辑器，请自行上网查找其它的编辑器。

---