刘毅的技术博客

记录自己的学习生活点滴,也希望和大家交流分享!

Markdown入门级教程

Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。这种语言吸收了很多在电子邮件”中已有的纯文本标记的特性。

Markdown语法简洁明了、学习成本低、而且与HTML完美兼容,所以成为了Bloger们的最爱,当下主流的博客平台Octopress、WordPress等都推荐使用Markdown。本文将介绍一些基本的Markdown语法规则,仅作入门之用。

语法

语法介绍的格式将采取上面代码,下面实际效果的格式,方便查看。

1、换行和分割线

1
2
3
4
5
6
7
8
9
10
11
12
13
14
单个回车
不能换行

行尾添加两个空格,这里->
可以强制换行

连续回车

可以分段

要生成水平分割线,可以在单独一行里输入3个或以上的短横线、星号或者下划线实现。短横线和星号之间可以输入任意空格。以下每一行都产生一条水平分割线。
* * *
*****
---------------------------------------

单个回车 不能换行

行尾添加两个空格,这里->
可以换行

连续回车

可以分段

要生成水平分割线,可以在单独一行里输入3个或以上的短横线、星号或者下划线实现。短横线和星号之间可以输入任意空格。以下每一行都产生一条水平分割线。




2、标题

1
2
3
4
#一级标题
##二级标题
###···
######最小六级标题

一级标题

二级标题

···

最小六级标题
1
2
3
4
另一种一级标题写法
=
另一种二级标题写法
-

另一种一级标题写法

另一种二级标题写法

3、强调和引用

1
2
3
*注意* 或 _注意_ (斜体强调)  
**注意** 或 __注意__ (粗体强调)  
***注意*** 或 ___注意___ (斜粗体强调)  

注意注意 (斜体强调)
注意注意 (粗体强调)
注意注意 (斜粗体强调)

1
2
3
>引用只需要在被引用的内容段落开头加上右尖括号('>')即可。
你可以选择只在开头加一个。
也可以在每行前面都加一个,效果是一样的。

引用只需要在被引用的内容段落开头加上右尖括号(‘>’)即可。 你可以选择只在开头加一个。 也可以在每行前面都加一个,效果是一样的。

1
2
3
4
5
6
> 嵌套引用:这是一个引用。这是第一行。  
这是第二行。
>> 这是一个嵌套的引用。这是第一行。  
这是第二行。
> 
> 外层引用的第三行。前面需要一个视觉上的空行表示内层嵌套的结束,空行前面的('>')可有可无。

嵌套引用:这是一个引用。这是第一行。
这是第二行。

这是一个嵌套的引用。这是第一行。
这是第二行。

外层引用的第三行。前面需要一个视觉上的空行表示内层嵌套的结束,空行前面的(‘>’)可有可无。

4、列表

1
2
3
4
* 无序列表的一项(*也可用+或-代替,\*后要有一个空格)
  * 嵌套列表子项,要以一个制表符或者4个空格缩进
      * 最多支持三级嵌套缩进
* 无序列表的另一项
  • 无序列表的一项(*也可用+或-代替,*后要有一个空格)
    • 嵌套列表子项,要以一个制表符或者4个空格缩进
      • 最多支持三级嵌套缩进
  • 无序列表的另一项
1
2
3
1. 有序列表项目1(同样标识符与内容间有空格)
2. 有序列表项目2
3. 有序列表项目3
  1. 有序列表项目1(同样标识符与内容间有空格)
  2. 有序列表项目2
  3. 有序列表项目3

5、代码片段

1
2
3
4
5
6
7
8
9
10
//行的开头空4个空格,表示程序代码(或者用两段```包起来,可显示行号)
int main(int argc, const char * argv[])
{

    @autoreleasepool {

        NSLog(@"Hello, World!");
    }
    return 0;
}

6、链接和图片

直接标注链接:<http://www.baidu.com>  
链接文字:[百度](http://www.baidu.com)  
索引方式链接文字:[百度][1]  
图像和链接非常类似,区别在开头加一个惊叹号:![百度情人节Logo](http://www.baidu.com/img/pc270x119_16f8c8283f357d242afa2d432c051d44.gif)  
也可以使用索引方式:![百度情人节Logo][2]  
另:引用本地图片:<img src="/images/baidu_lover'sDay.gif">

[1]:http://www.baidu.com
[2]:http://www.baidu.com/img/pc270x119_16f8c8283f357d242afa2d432c051d44.gif

直接标注链接:http://www.baidu.com
链接文字:百度
索引方式链接文字:百度
图像和链接非常类似,区别在开头加一个惊叹号:百度情人节Logo
也可以使用索引方式:百度情人节Logo
另:引用本地图片:

编辑器

Mac环境下推荐使用Mou,一个Mac平台上轻量级的Markdown编辑器,非常好用!

进一步学习

如果你想深入学习下Markdown语法,可参考以下内容:
http://wowubuntu.com/markdown/index.html
http://www.ituring.com.cn/article/504

PS:当天是情人节加元宵节,祝我女朋友晓莉永远美丽漂亮,天天开心快乐,愿我们能幸福相伴一生!

6vvqnj09Z6