MarkDown Learning

2017-10-19

Blog

我们大多数人或多或少会写一些文档，或者是随笔，可能因为工作，可能因为个人爱好；而如果我们是用word来完成我们的写作，其实是一件很麻烦的事，我们不否认word功能的强大，能给出我们提供非常漂亮的布局，但是如果对word不是很熟悉，就会在排版上花很多时间，不能专心在写作上；但是如果使用时记事本之类的，又不能够有很好的阅读体验；有什么可以解决我们的痛点呢？答案是Markdown !

Markdown介绍

Markdown是什么？Markdown是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML(或者HTML)文档，Markdown的语法十分简单。常用的标记符号也不超过十个，学习成本也不需要太多。

Markdown基础语法

标题

标题是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定义为标题，只要在这段文字前加 # 号即可，注意的是#和标题名之间要用一个空格隔开。

Markdown语法如下：

# 一级标题

## 二级标题

### 三级标题

实现效果如下：

一级标题

二级标题

三级标题

以此类推，Markdown总共支持6级标题。

列表

在 Markdown 下，列表分为有序列表与无序列表的区别：

有序列表直接在文字前加上 1. 2. 3.
无序列表在文字前面加上 -或者*即可
注意不管是有序列表还是无序列表，符号和文字之间都需要加上一个空格

Markdown语法如下：

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

-   以 - 开头的无序列表1
-   以 - 开头的无序列表2
-   以 - 开头的无序列表3

*   以 * 开头的无序列表1
*   以 * 开头的无序列表2
*   以 * 开头的无序列表3

实现效果如下：

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

以 - 开头的无序列表1
以 - 开头的无序列表2
以 - 开头的无序列表3

以 * 开头的无序列表1
以 * 开头的无序列表2
以 * 开头的无序列表3

区块引用

标记区块引用是使用类似 email 中用 > 的引用方式，在每行的最前面加上 >,并用空格隔开。

Markdown语法如下：

> 这是一个区块引用
> 这是一个区块引用

实现效果：

这是一个区块引用
这是一个区块引用

代码区域

对于程序员来说，有的时候需要插入代码；Markdown提供了优雅的代码区域，只需要用两个(3个 ` 就是tab键上面的)把中间的代码包裹起来即可；如果在第一个后面加上所使用的语言即可语法高亮显示。

Markdown语法如下：

''' c
	int Main(string[] args)
	{
		Console.WriteLine("hello world");
		return 0;
	}
'''

实现效果：

int Main(string[] args)
{
	Console.WriteLine("hello world");
	return 0;
}

此外，如果代码很少，几个单词的长度之类的；也可以使用两个”`”把代码包裹起来显示。

Markdown语法如下：

`function Test()`

实现效果：

function Test()

表格

表格也是Markdown的很方便的功能,以|包裹，第一行是表头，第二行是表头和内容的分隔，同时也负责对齐功能，:–表示左对齐，:—-:表示就是居中对齐，—:表示右对齐。

Markdown语法如下：

| title1 | title2 | title3 |
| :-- | :----: | --: |
| 1 | 2 | 3 |

实现效果：

title1	title2	title3
1	2	3

虽然表格的书写比较复杂，但是很多Markdown编辑器能够直接生成表格，所以也是很方便的。

分割线

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

Markdown语法如下：

***
* * *

---
- - -
___
_ _ _

实现效果：

链接

Markdown 支持两种形式的链接语法： 行内式和参考式两种形式，不管是哪一种，链接文字都是用[方括号] 来标记。

要建立一个行内式的链接，只要在[方块括号]后面紧接着(圆括号)并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可。

Markdown语法如下：

这个是一个[行内式链接](https://www.baidu.com)

这个是一个[行内式带标题的链接](https://www.baidu.com "title")

这个是一个[参考式链接]

这个是一个[参考式带标题的链接]

[参考式链接]: https://www.baidu.com
[参考式带标题的链接]: https://www.baidu.com "title"

实现效果：
这个是一个行内式链接

这个是一个行内式带标题的链接

这个是一个参考式链接

这个是一个参考式带标题的链接

图片

Markdown使用一种和链接很相似的语法来标记图片，允许两种样式: 行内式和参考式，格式为：一个惊叹号 !，接着一个[方括号]，里面放上图片的替代文字，接着一个(普通括号)，里面放上图片的网址，最后还可以用引号包住并加上选择性的 ‘title’ 文字。

Markdown语法如下：

这个是一个![](路径url)

这个是一个！[行内式带标题的图片](路径url "title")

这个是一个！[参考式图片][id1]

这个是一个![参考式带标题的图片][id2]

[id1]: 路径url
[id1]: 路径url "title"

实现效果：
Alipay

^_^ This article ends Thank you for reading ^_^