Markdown 是什么？

Markdown 是一种 轻量级标记语言 ，创始人为 约翰 · 格鲁伯 (John Gruber) 。它允许人们 “使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML (或者 HTML ) 文档”。
——维基百科

换成人话就是，Markdown 是一种 格式语言 ，用简洁的缩进和常用符号语法代替排版，可以让人专注于文本内容。和 Word 等工具的区别是，Markdown 在编辑文本内容的时候，输入几个符号就能完成排版工作，而 Word 需要在工具栏中进行点选操作。Markdown 虽然没有那么多可以调整的格式细节，但是用 Markdown 写出来的文档足够简洁，美观，用在微信公众号，个人博客，论坛等已足够。并且 Markdown 支持 HTML 标签 ，能满足多数场合下的排版需求。

在哪里写 Markdown ？

有很多专门用来写 markdown 的编辑器，在线的或者离线的，我一直觉得专门写 markdown 的编辑器有点多余，从来没用过。我一直用代码编辑器来写 markdown，之前用 Sublime Text ，但有了 Atom ，就只用 Atom 了。

在 Atom 里面，用插件可以显示 markdown 的效果（markdown-preview），也可以直接导出 PDF 或者 HTML 版本，非常好用。

Markdown 命令快速查询

段落和换行

行尾添加 两个空格 或 一个回车。

标题

级数越小 ， 标题越大 。

1
2
3
4
5
6
#       标题内容（一级标题）
##      标题内容（二级标题）
###     标题内容（三级标题）
####    标题内容（四级标题）
#####   标题内容（五级标题）
######  标题内容（六级标题）

区块引用

引用符号可以嵌套，且引用的区块内可以使用其他语法。

1
2
>       引用内容

代码插入

代码插入分为 行内代码 和 代码块 。

行内代码

行内代码用 `</code > 包裹或者用 < code > 标签 </ code > 包裹。

代码块

代码块用三个 `</code > 标识
代码块的三个 `</code > 之后加上 空格 </code > 和 语言名称 ，即可高亮显示该语言

列表

Markdown 支持 有序列表 和 无序列表 。
无序列表 使用星号 * 、加号 + 、减号 - 作为标记
有序列表 使用数字接着一个英文句点， 1.

表格

表格对齐方式的设置方法（减号最少可以一个)
居左：:- - -
居中：:- - -: 或 - - - - -
居右：- - -:

1
2
3
4
5
6
| 标题 | 标题 | 标题 |
|:-|-|-:|
| 居左测试文本 | 居中测试文本 | 居右测试文本 |
| 居左测试文本 1 | 居中测试文本 2 | 居右测试文本 3|
| 居左测试文本 11 | 居中测试文本 22 | 居右测试文本 33|
| 居左测试文本 111 | 居中测试文本 222 | 居右测试文本 333|

分割线

一行中用三个以上的星号 * 、减号 - 、底线 _ 来建立一个分隔线，行内不能有其他东西。

1
2
3
***
---
___

链接

有两种形式， 行内式 和 参考式 。也或者用 < > 把网址包裹即可把网址变成链接。

行内式 

1
[This link](http://example.net/)

参考式

参考式的链接是在链接文字的括号后面再接上另一个方括号 []，而在第二个方括号里面要填入用以辨识链接的标记。

1
This is [an example][id] reference-style link.

接着，在文件的任意处，你可以把这个标记的链接内容定义出来。
1
[id]: http://example.com/  "Optional Title Here"

“Optional Title Here” 是鼠标停留在链接时弹出的提示信息

邮件

用 < > 把邮件地址包裹即可把邮件地址变成链接。

1
<test@gmail.com>

强调

Markdown 使用星号 *、底线 _ 或波浪线 ~ 作为标记强调字词的符号。

也可以用 HTML 标签 <u> </u> 对文字包裹进行下划线处理。

1
2
3
4
5
6
7
8
*word*      斜体（一个星号包裹）
_word_      斜体（一个底线包裹）  

**word**    加粗（两个星号包裹）
__word__    加粗（两个底线包裹）   

~~word~~    删除（两个波浪线包裹）
<u>word</u> 下划线（ HTML 标签包裹）

强调也可以直接插在文字中间。
但是如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线，你可以用反斜线 \ 。

图片

有两种形式， 行内式 和 参考式 。

行内式 

1
![Alt text](/path/to/img.jpg "Optional title")

参考式 
1
![Alt text][id]

[id] 是图片参考的名称，图片参考的定义方式则和连结参考一样
1
[id]: url/to/image  "Optional title attribute"

如果要限制图片大小和图片的相对位置，可以用 HTML 标签来限制。
限制图片大小： <img src="图片地址" width="图片显示宽度" height="显示高度" alt="图片名称"/>
限制图片相对位置： <div align=center></div> 用这个标签包裹 img 标签即可

反斜杠

Markdown 可以利用反斜杠 \ 来插入一些在语法中有其它意义的符号。

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号。

1
2
3
4
5
6
7
8
9
10
11
12
\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

Markdown 中常用的 HTML 标签

字体 

1
2
<font face="微软雅黑" color="red" size="6"> 字体及字体颜色和大小 </font>
<font color="#0000ff"> 字体颜色 </font>

文本对齐方式 

1
2
3
<p align="left"> 居左文本 </p>
<p align="center"> 居中文本 </p>
<p align="right"> 居右文本 </p>

参考资料

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