Markdown快速入门

发表于 更新于 分类于 阅读次数：

摘要

Markdown快速入门中文文档对于非编程人员来说理解有一定的难度。笔者写这篇文章的目的有两个，一个是尝试用更加简单的方式来讲解Markdown语法；二是对自己学习的一个总结。

Markdown简介

Markdown 的目标是实现「易读易写」。Markdown 语法的目标是：成为一种适用于网络的书写语言。
Markdown可以用来写文档、做笔记和写博客，让你更专注于内容而不是排版。它的语法易记，掌握后你会发现使用简单的标记就可以实现简洁大方的排版。本博客的所有排版都是用的Markdown语言实现的。

Markdown语法

标题

Markdown 支持两种标题的语法，Setext 和 atx 形式。Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），Atx 形式在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。

1. Setext形式标题

内容
=== （最高阶标题）

内容
--- （第二阶标题）

注释：上面的最高阶标题和第二阶标题分别用了三个连续的=和-，实际上都只需要一个就可以了。由于个人习惯，笔者喜欢用三到五个符号。

2. atx 形式形式标题

# 内容 （一级标题）
## 内容 （二级标题）
### 内容 （三级标题）
#### 内容 （四级标题）
##### 内容 （五级标题）
###### 内容 （六级标题）

注释：上面语法中的最后一个#和内容之间一般需要一个空格。

无序列表

- 内容
- 内容
- 内容

注释：可以把上面无序列表语法中的-号换成+或者*,还可以嵌套使用。

有序列表

1. 内容
2. 内容
3. 内容

注释：有序列表可以和无序列表相互嵌套使用。

链接

Markdown 支援两种形式的链接语法：行内和参考两种形式，两种都是使用角括号来把文字转成连结。行内形式是直接在后面用括号直接接上链接，你也可以选择性的加上 title 属性（也就是鼠标Tips）；参考形式的链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容。

1. 行内链接

[百度](http://www.baidu.com "这是百度链接")

注释：上面行内链接语法中，引号部分类容是鼠标移到链接文字上是显示的Tips，这部分可以省略。

2. 参考链接

[Google][1]、[GitHub][2]和[百度][3]都是程序猿经常访问的网页。

[1]: http://google.com/ "Google首页"
[2]: https://github.com/ "GitHub首页"
[3]: http://www.baidu.com/ "百度首页"

注释：上面参考链接语法中，引号部分类容也表示鼠标移到链接文字上是显示的Tips，这部分可以省略。

图片

图片的语法和链接很像，也分为行内形式和参考形式。插入图片只是在插入链接的语法的前面多加了一个感叹号。所以，这里只写出行内形式的语法，参考形式自己举一反三。

行内形式

![百度Logo](https://www.baidu.com/img/bdlogo.png "百度")

引入代码

1
2
3
``` 语言类型	（代码引入开始）
	代码片段
``` 		（代码引入结束）

注释：用三个“`”（英文反引号，~键下面的符号，也就是Esc键下方的那个键）引入代码，三个英文反引号后可以加语言类型（可加可不加），用三个单引号结束代码引入。

引用

> 内容

粗体和斜体

粗体语法：**内容**
斜体语法：*内容*

段落

一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。普通段落不该用空格或制表符来缩进。

注释：段落可以在行首用一个Tab或者四个空格来实现，笔者一般喜欢用在行首输入一个制表符（点击一下Tab键）来实现。

水平分割线

三个或三个以上的减号、星号或者下划线。

注释：因为减号也是第二阶标题的标记符号，所以如果使用减号表示分割线时，要保证减号的前一行没有内容，也就是要保持至少一行的空行。

在行内引入代码

语法：

1
`行内代码`

效果：
这是行内代码效果

注释：这个标记可以用来在正文的某一行中引入一句代码或者代码关键词。

表格

语法：

1
2
3
4
5
| 学号		| 姓名		| 年龄 |
| --------- |:---------:| ----:|
| 1001		| 张三		|18 |
| 1002		| 李四		|	17 |
| 1003		| 王五		| 20 |

效果：

学号 姓名 年龄
1001 张三 18
1002 李四 17
1003 王五 20

注释：有的Markdown解释器不支持表格语法。用减号表示表头分割线，冒号表示内容对齐方式。没有冒号表示默认左对齐，冒号在表头分割线左边表示左对齐，在右边表示右对齐，左右两边都有表示居中对齐。

删除线

语法：

1
~~删除线~~

效果：
这是删除线效果

快速掌握

Markdown语法有很多标签，对于初学者来说，可以先从下面这个八个基本标签开始。实际上，这八个基本标签也是最经常使用到的标签，掌握这几个标签，基本上就可以胜任大部分的排版需求。

  • 标题 —> #
  • 加粗 —> **加粗**
  • 斜体 —> *斜体*
  • 块引用 —> >
  • 链接 —> []()
  • 图片 —> ![]()
  • 列表 —> +
  • 分割线 —> ---

其他

发现一个比较系统的介绍 Markdown 写作的开源项目[Markdown for Science]（https://github.com/karthik/markdown_science/wiki） 。其中有一篇 Markdown 的入门教程 Learn markdown in 3 minutes 写得通俗易懂。

参考文章

Markdown 语法说明 (简体中文版)

小提示：一般初学者可以先看Markdown语法的快速入门。