Markdown标记语言语法及使用实例

markdown简介

Markdown简介　　Markdown 是一种轻量级的标记语言，由John Gruber和Aaron Swartz创建，使其成为可读性最大并可再发行的可输入输出的格式。这种语言创建灵感来自于已经存在的带标记的电子邮件文本。Markdown 允许 HTML 语法, 所以使用者如果需要可以直接用 HTML来表示是可以的。Markdown最初由Gruber应用在Perl语言中，但现在已经有多种编程语言应用了。它是开源项目，并以BSD-style许可证的许可方式以插件形式或内容管理系统形式发布。

我用的markdown编译器为有道词典自带的markdown文本编辑器，很好用

一、标题

标题很简单，前面以 # 开头，有几个 #，就表示是几级标题，注意符号 和 文字之间的间隔

example：

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

二、列表

1、无序列表，在 文字之间添加 -，+ 或者 * 符号，注意 符号 与 文字之间的空格

2、有序列表，以数字开头，数字后面接一个点号【.】，注意点号 与 文字之间的间隔

example:

- 无序列表一

- 无序列表二

- 无序列表三

- 无序列表四

1. 有序列表一

2. 有序列表二

3. 有序列表三

4. 有序列表四

三、分割线

分割线很简单，*** 或者 --- 都表示分割线

example:

***

---

四、链接

链接很简单，[要显示的文字] + (链接)

example：

[BaiDu](http://baidu.com)

五、图片

图片很简单，！ + [mou icon] + (图片链接)

example：


六、斜体，粗体，粗斜体

很简单，一个 * 括起来 表示斜体；两个 * 括起来 表示 粗体；三个 * 括起来 表示 粗斜体

example：

*斜体*

**粗体**

***粗斜体***

七、特殊符号

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

\ 反斜线

` 反引号

* 星号

_ 底线

{} 花括号

[] 方括号

() 括弧

# 井字号

+ 加号

- 减号

. 英文句点

! 惊叹号

2、其它一些特殊符号

30° 表示度数

© 表示版权符号

注意：小于号 前后 都要 有空格，避免当做 特殊符号处理

八、代码区

空格代码区很简单，将代码用两个```包含起来就 ok 了

example：

```

private void getMarkdown(){

System.out.println("我是一个Java方法");

}

```

九、表格

表格我不多说了，直接看图文吧，注意：中间对齐，左边对齐，右边对齐，文本删除符号，文本斜体

example：

姓名 | 年龄

----------- | -----------

李白 | 47

王安石 | 58

| 左边对齐 | 中间对齐 | 右边对齐

| :------------ | :-----------:| ----------: |

| 李白 | 杜牧 |赵孟頫|

| Jack | ~~Bob~~ | _Charies_ |

十、段内换行与换段落

1、段内换行：在一句话结尾处 连续 输入 两个 空格，然后再输入 一个 回车键

2、换段落：连续输入 两个 回车键

3、我们可以看到段内换行与换段落的差别，段内换行上下两句文本间隔很小，而换段落上下两句文本间间隔很大。

十一、markdown中实现首行缩进的两种方法

由于markdown语法主要考虑的是英文，所以对于中文的首行缩进并不太友好，两种方法都可以完美解决这个问题。

1、把输入法由半角改为全角。 两次空格之后就能够有两个汉字的缩进。

2、在开头的时候，先输入下面的代码，然后紧跟着输入文本即可。分号也不要掉。 

直接写：

半方大的空白 或 

全方大的空白 或 

不断行的空白格 或 

十二、表情符号

更多表情见：

https://github.com/guodongxiaren/README/blob/master/emoji.md

十三、参考资料

1、认识 Markdown

http://sspai.com/25137

2、Wossoneri

http://www.cnblogs.com/rossoneri/p/4446440.html

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

http://wowubuntu.com/markdown/#list

4、欢迎使用CSDN-markdown编辑器

http://write.blog.csdn.net/mdeditor