Markdown语法示例
在搭建好blog之后,下一步就是写博文了,而要想方便的进行博客写作,那么Markdown是必不可少的工具。本文将通过一些简单的例子来说明Markdown的用法。
Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)。 它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
宗旨
Markdown 的目标是实现「易读易写」。
可读性,无论如何,都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响,包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText,而最大灵感来源其实是纯文本电子邮件的格式。
总之, Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像强调。Markdown 的列表看起来,嗯,就是列表。Markdown 的区块引用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。
标题
Markdown提供了两种方式(Setext和Atx)来显示标题。
语法:
Setext方式
标题1
=================
标题2
-----------------
Atx方式
# 标题1
## 标题2
###### 标题6
效果:
Setext方式
标题1
=================
标题2
Atx方式
# 标题1
## 标题2
###### 标题6
换行
在文字的末尾使用两个或两个以上的空格来表示换行。
引用
行首使用>加上一个空格表示引用段落,内部可以嵌套多个引用。
语法:
> 这是一个引用,
> 这里木有换行,
> 在这里换行了。
> > 内部嵌套
效果:
这是一个引用, 这里木有换行,
在这里换行了。 > 内部嵌套
列表
__无序列表__使用*、+或-后面加上空格来表示。
语法:
* Item 1
* Item 2
* Item 3
+ Item 1
+ Item 2
+ Item 3
- Item 1
- Item 2
- Item 3
效果:
- Item 1
- Item 2
-
Item 3
- Item 1
- Item 2
-
Item 3
- Item 1
- Item 2
- Item 3
__有序列表__使用数字加英文句号加空格表示。
语法:
1. Item 1
2. Item 2
3. Item 3
效果:
- Item 1
- Item 2
- Item 3
代码区域
__行内代码__使用反斜杠`表示。
__代码段落__则是在每行文字前加4个空格或者1个缩进符表示。
语法:
Bash中可以使用echo来进行输出。
$ echo 'Something'
$ echo -e '\tSomething\n'
效果:
Bash中可以使用echo来进行输出。
$ echo 'Something'
$ echo -e '\tSomething\n'
强调
Markdown使用\*或\_表示强调。
语法:
单星号 = *斜体*
单下划线 = _斜体_
双星号 = **加粗**
双下划线 = __加粗__
效果:
单星号 = 斜体
单下划线 = 斜体
双星号 = 加粗
双下划线 = 加粗
链接
Markdown支持两种风格的链接:Inline和Reference。
语法:
Inline:以中括号标记显示的链接文本,后面紧跟用小括号包围的链接。如果链接有title属性,则在链接中使用空格加“title属性”。
Reference:一般应用于多个不同位置使用相同链接。通常分为两个部分,调用部分为[链接文本][ref];定义部分可以出现在文本中的其他位置,格式为[ref]: http://some/link/address (可选的标题)。
注:ref中不区分大小写。
这是一个Inline[示例](http://winares.github.com "可选的title")。
这是一个Reference[示例][ref]。
[ref]: http://winares.github.com
效果:
这是一个Inline示例。
这是一个Reference[示例][ref]。
[ref]: http://winares.github.com
图片
图片的使用方法基本上和链接类似,只是在中括号前加叹号。
注:Markdown不能设置图片大小,如果必须设置则应使用HTML标记<img>。
语法:
Inline示例:
Reference示例:![替代文本][pic]
[pic]: /assets/images/ship.jpg "可选的title"
HTML示例:<img src="/assets/images/jian.jpg" alt="替代文本" title="标题文本" width="200" />
效果:

其他
自动链接
使用尖括号,可以为输入的URL或者邮箱自动创建链接。如test@domain.com。
分隔线
在一行中使用三个或三个以上的*、-或_可以添加分隔线,其中可以有空白,但是不能有其他字符。
转义字符
Markdown中的转义字符为\,可以转义的有:
- \\ 反斜杠
- \` 反引号
- \* 星号
- \_ 下划线
- \{\} 大括号
- \[\] 中括号
- \(\) 小括号
- \# 井号
- \+ 加号
- \- 减号
- \. 英文句号
- \! 感叹号
结语
Markdown语法很大程度上减少了编辑的成本,但是在写作这篇文章的时候也发现某些标记对中文的支持似乎并不完美,虽然这些缺陷可以通过直接插入HTML代码解决(但这么做一点都不漂亮)。总的来说,能够在离线状态下使用命令行模式进行写作还是很爽的,相比在线写作模式精力可以更专注。
欢迎转载,转载请注明作者及出处winares.github.com,请勿用于商业用途
本文地址:http://winares.github.com/2013/11/21/markdown-grammer-examples