Kylexlau's Weblog

Markdown 标记语言指南

发明者

Markdown 的发明者是 John Gruber 和 Aaron Swartz,目标是 “to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML)"。

John Gruber 是一个作家,有计算机学士学位,苹果迷。他最有名的一个项目是 Daring Fireball 网站,一个主要写苹果产品相关信息的技术博客,从2006年4月开始,他全职维护此网站。

Aaron Swartz 是一个非常年轻有为的家伙,一大把的经历和成绩。他的个人网站里列出了他的所有成绩。

语法

标题

  • Setext-style, 使用等于号(=)和下杠(_)。
  • Atx-style 使用井号(#),一个井号是H1,两个是H2,依此类推。Atx 是 Aaron Swartz 发明的另一种文本标记语言。

列表

  • 无序列表, 星号(*),加号(+),或者减号(-)都行。
  • 有序列表, 直接使用1、2、3这种数字。

链接

行内:

This is an [example link](http://example.com/ "With a Title").

引用:

I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].

[1]: http://google.com/        "Google"
[2]: http://search.yahoo.com/  "Yahoo Search"
[3]: http://search.msn.com/    "MSN Search"

自动:用括号将链接或email地址括起来,就会自动生产链接。

图片

行内:

![alt text](/path/to/img.jpg "Title")

引用:

![alt text][id]

[id]: /path/to/img.jpg "Title"

代码

使用backtick quotes(`)。

缩进四个字符或者一个tab。

引用

就像电子邮件里一样,使用大于号(>)。

> This is a blockquote.
>
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote

强调

星号(*)或者下杠(_),一个星号代表斜体,两个星号代表粗体,三个星号是斜粗体,下杠一样。

横线

三个或三个以上的中杠(-),星号(*),下杠(_),产生一个<hr /> tag,也就是一条横线。

转义

可以对如下字符进行转义:

  • \ backslash
  • ` backtick
  • * asterisk
  • _ underscore
  • {} curly braces
  • [] square brackets
  • () parentheses
  • # hash mark
  • + plus sign
  • - minus sign (hyphen)
  • . dot
  • ! exclamation mark

参考