Markdown学习

1. ⼀一起来学MarkDown
wanqiang.ji@gmail.com
2013-10-28

2. MarkDown宗旨
•
Markdown 的⺫⽬目标是实现「易读易写」。
•
可读性，⽆无论如何，都是最重要的。⼀一份使⽤用 Markdown 格式
撰写的⽂文件应该可以直接以纯⽂文本发布，并且看起来不会像是
由许多标签或是格式指令所构成。Markdown 语法受到⼀一些既
有 text-to-HTML 格式的影响，包括 Setext、atx、Textile、
reStructuredText、Grutatext 和 EtText，⽽而最⼤大灵感来源其实
是纯⽂文本电⼦子邮件的格式。
•
总之， Markdown 的语法全由⼀一些符号所组成，这些符号经过
精挑细选，其作⽤用⼀一⺫⽬目了然。⽐比如：在⽂文字两旁加上星号，看
起来就像*强调*。Markdown 的列表看起来就是列表。
Markdown 的区块引⽤用看起来就真的像是引⽤用⼀一段⽂文字，就像
你曾在电⼦子邮件中⻅见过的那样。

3. MarkDown兼容HTML
•
Markdown 语法的⺫⽬目标是：成为⼀一种适⽤用于⺴⽹网络的书写语⾔言。
•
Markdown 不是想要取代 HTML，甚⾄至也没有要和它相近，它的语法种类很
少，只对应 HTML 标记的⼀一⼩小部分。Markdown 的构想不是要使得 HTML ⽂文档
更容易书写。在我看来， HTML 已经很容易写了。Markdown 的理念是，能让
⽂文档更容易读、写和随意改。HTML 是⼀一种发布的格式，Markdown 是⼀一种书
写的格式。就这样，Markdown 的格式语法只涵盖纯⽂文本可以涵盖的范围。
•
不在 Markdown 涵盖范围之内的标签，都可以直接在⽂文档⾥里⾯面⽤用 HTML 撰写。
不需要额外标注这是 HTML 或是 Markdown；只要直接加标签就可以了。
•
要制约的只有⼀一些 HTML 区块元素――⽐比如 <div>、<table>、<pre>、<p>
等标签，必须在前后加上空⾏行与其它内容区隔开，还要求它们的开始标签与结
尾标签不能⽤用制表符或空格来缩进。Markdown 的⽣生成器有⾜足够智能，不会在
HTML 区块标签外加上不必要的 <p> 标签。

4. 段落、标题、区块代码
•
⼀一个段落是由⼀一个以上的连接的⾏行句组成，⽽而⼀一个以
上的空⾏行则会划分出不同的段落（空⾏行的定义是显⽰示
上看起来像是空⾏行，就被视为空⾏行，例如有⼀一⾏行只有
空⽩白和 tab，那该⾏行也会被视为空⾏行），⼀一般的段落
不需要⽤用空⽩白或换⾏行缩进。
•
Markdown ⽀支持两种标题的语法，Setext 和 atx 形
式。Setext 形式是⽤用底线的形式，利⽤用 = （最⾼高阶标
题）和 - （第⼆二阶标题），Atx 形式在⾏行⾸首插⼊入 1 到 6
个 # ，对应到标题 1 到 6 阶。
•
区块引⽤用则使⽤用 email 形式的 '>' ⾓角括号。

5. MarkDown语法⽰示例
A First Level Header
====================
A Second Level Header
--------------------!
Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.
!
The quick brown fox jumped over the lazy
dog's back.
### Header 3
!
> This is a blockquote.
>
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote

6. 输出HTML代码
<h1>A First Level Header</h1>
<h2>A Second Level Header</h2>
<p>Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.</p>
<p>The quick brown fox jumped over the lazy
dog's back.</p>
<h3>Header 3</h3>
<blockquote>
<p>This is a blockquote.</p>
<p>This is the second paragraph in the blockquote.</p>
<h2>This is an H2 in a blockquote</h2>
</blockquote>

7. 修辞与强调
•
Markdown 使⽤用星号和底线来标记需要强调的区段。
Some of these words *are emphasized*.
Some of these words _are emphasized
also_.
!
Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores
instead__.
<p>
Some of these words
<em>are emphasized</em>
.Some of these words
<em>are emphasized also</em>
.
</p>
<p>
Use two asterisks for
<strong>strong emphasis</strong>
.Or, if you prefer,
<strong>use two underscores instead</strong>
.
</p>

8. 列表
•
⽆无序列表使⽤用星号、加号和减号来做为列表的项⺫⽬目标记
* Candy.
* Gum.
* Booze.
•
+ Candy.
+ Gum.
+ Booze.
- Candy.
- Gum.
- Booze.
<ul>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ul>
有序的列表则是使⽤用⼀一般的数字接着⼀一个英⽂文句点作为项⺫⽬目标记
1. Red
2. Green
3. Blue
<ol>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ol>

9. 链接
•
Markdown ⽀支持两种形式的链接语法：⾏行内和参考两种形式，两种都是使⽤用⾓角
括号来把⽂文字转成连结。
This is an [example link](http://example.com/ “With a Title”).
<p>
This is an <a href="http://example.com/" title="With a Title">example link</a>.
</p>
•
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"
<p>
I get 10 times more traffic from <a href="http://
google.com/"
title="Google">Google</a> than from <a
href="http://search.yahoo.com/"
title="Yahoo Search">Yahoo</a> or <a href="http://
search.msn.com/"
title="MSN Search”>MSN</a>.
</p>

10. 图⽚片
•
图⽚片的语法与链接的语法极其相似
⾏行内形式（title 是选择性的）：
!
参考形式：
![alt text][id]
[id]: http://www.baidu.com/img/bdlogo.gif "百度"
<img src="http://www.baidu.com/img/bdlogo.gif" alt="alt text" title="百度" />

11. 代码
•
在⼀一般的段落⽂文字中，你可以使⽤用反引号 ` 来标
记代码区段，区段内的 &、< 和 > 都会被⾃自动的
转换成 HTML 实体，这项特性让你可以很容易的
在代码区段内插⼊入 HTML 码：
I strongly recommend against using any `<blink>`
tags.
!
I wish SmartyPants used named entities like
`&mdash;`
instead of decimal-encoded entites like `&#8212;`.
<p>
I strongly recommend against using any<code>&lt;blink&gt;</code> tags.
</p>
<p>
I wish SmartyPants used named entities like<code>&amp;mdash;</code> instead of decimal-encoded
entites like <code>&amp;#8212;</code>.
</p>

12. DIY!
http://daringfireball.net/projects/markdown/dingus