初识Markdown

快速入门(完整文档点击这里)

段落、标题、区块代码

  1. 段落是由一个以上的连接的行句组成,而一个以上的空行则会划分出不同的段落(空行的定义是显示上看起来像是空行,就被视为空行,例如有一行只有空白和 tab,那么该行也被视为空行),一般的段落不需要空白或换行缩进。
  2. 标题 有两种写法,Setextatx形式。Setext形式是用底线的形式,利用=(最高阶标题)和-(第二阶标题),Atx形式在行首插入1到6个#,对应标题1到6阶。
  3. 区块 引用则使用email形式的>角括号。

Markdown语法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
一级标题:
# H1
H1
==
二级标题:
## H2
H2
--
段落:
这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落。
这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落。
区块:
>一级标题:
># H1
>
>H1
>==
>
>二级标题:
>## H2
>
>H2
>--
>
>段落:
>
>这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一>段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段
>落,这是一段段落,这是一段段落,这是一段段落。
>
>这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一
>段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段
>落,这是一段段落,这是一段段落,这是一段段落。

输出HTML为:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<p>一级标题:</p>
<h1>H1</h1>
<h1>H1 <h1>
<p>二级标题:</p>
<h2>H2</h2>
<h2>H2</h2>
<p>段落:</p>
<p>这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落。</p>
<p>这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段落。</p>
<p>区块:</p>
<blockquote><p>一级标题:</p><h1>H1</h1><h1>H1</h1><p>二级标题:</p><h2>H2</h2><h2>H2</h2><p>段落:</p><p>这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一&gt;段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段
落,这是一段段落,这是一段段落,这是一段段落。</p><p>这是一段段落,这是一段段落,这是一段段落,这是一段段落,这是一
段段落,这是一段段落,这是一段段落,这是一段段落,这是一段段
落,这是一段段落,这是一段段落,这是一段段落。</p></blockquote>

效果显示:

修辞和强调

Markdown 使用*_来标记需要强调的区段

Markdown语法:

1
2
3
4
5
*需要强调的内容*
_需要强调的内容_
**需要着重强调的内容**
__需要着重强调的内容__

输出HTML为:

1
2
3
4
5
<p><em>需要强调的内容</em>
<em>需要强调的内容</em></p>
<p><strong>需要着重强调的内容</strong>
<strong>需要着重强调的内容</strong></p>

列表

  1. 无序列表使用*+-来作为列表额项目标记,这些符号都是可以使用的。

  2. 有序列表使用数字加.来作为列表额项目标记,这些符号都是可以使用的。

  3. 如果你在项目之间插入空行,那项目的内容会用<p>包起来,你也可以在一个项目内放上多个段落,只要在它前面缩排 4 个空白或 1 个 tab 。

Markdown语法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
无序列表:
使用 * :
* Candy
* Gum
* Booze
使用 + :
+ Candy
+ Gum
+ Booze
使用 - :
- Candy
- Gum
- Booze
有序列表:
1. Candy
2. Gum
3. Booze
段落列表:
* 这是一个列表元素
添加段落
添加段落
* 这是另一个列表元素

输出HTML为:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<p>无序列表:</p>
<p>使用 * :</p>
<ul><li>Candy</li><li>Gum</li><li>Booze</li></ul>
<p>使用 + :</p>
<ul><li>Candy</li><li>Gum</li><li>Booze</li></ul>
<p>使用 - :</p>
<ul><li>Candy</li><li>Gum</li><li>Booze</li></ul>
<p>有序列表:
1. Candy
2. Gum
3. Booze</p>
<p>段落列表:</p>
<ul><li><p>这是一个列表元素
添加段落
添加段落</p></li><li><p>这是另一个列表元素</p></li></ul>

链接

Markdown 支持两种形式的链接语法:行内参考两种形式,两种都是使用角括号把文字转成连接。

Markdown语法:

1
2
3
4
5
6
7
8
9
行内形式:
this is an [example link](http://example.com/)
参考形式:
these are [Google][1],[Yahoo][2] and [MSN][3]
[1]: http://google.com/
[2]: http://search.yahoo.com/
[3]: http://search.msn.com/

输出HTML为:

1
2
3
4
5
<p>行内形式:
this is an <a href="http://example.com/">example link</a></p>
<p>参考形式:
these are <a href="http://google.com/">Google</a>,<a href="http://search.yahoo.com/">Yahoo</a> and <a href="http://search.msn.com/">MSN</a></p>

图片

图片的语法和链接很像,也分为行内参考

Markdown语法:

1
2
3
4
5
6
7
行内形式:
![alt text](/path/to/img.jpg "title")
参考形式:
![alt text][id]
[id]: /path/to/img.jpg "title"

输出HTML为:

1
2
3
4
5
<p>行内形式:
<img alt="alt text" title="title" src="/path/to/img.jpg"/></p>
<p>参考形式:
<img alt="alt text" src="/path/to/img.jpg" title="title"/></p>

代码

在一般的段落文字中,可以使用(`)来标记代码区段,区段内的&<>也一样会自动转成HTML实体。

Markdown语法:

1
2
3
4
5
6
7
8
9
10
11
12
I strongly recommend against using any `<blink>` tags.
I wish SmartyPants used named entities like `&mdash;`
instead of decimal-encoded entites like `&#8212;
If you want your page to validate under XHTML 1.0 Strict,
you've got to put paragraph tags in your blockquotes:
<blockquote>
<p>For example.</p>
</blockquote>

输出HTML为:

1
2
3
4
5
6
7
8
9
10
11
<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 `&amp;#8212;</p>
<p>If you want your page to validate under XHTML 1.0 Strict,
you&#39;ve got to put paragraph tags in your blockquotes:</p>
<p>&lt;blockquote&gt;
&lt;p&gt;For example.&lt;/p&gt;
&lt;/blockquote&gt;</p>

在这里测试一下吧!!!

Markdown 语法:

效果显示: