*:first-child {
margin-top: 0 !important;
}

body>*:last-child {
margin-bottom: 0 !important;
}

/* BLOCKS
=============================================================================*/

p, blockquote, ul, ol, dl, table, pre {
margin: 15px 0;
}

/* HEADERS
=============================================================================*/

h1, h2, h3, h4, h5, h6 {
margin: 20px 0 10px;
padding: 0;
font-weight: bold;
-webkit-font-smoothing: antialiased;
}

h1 tt, h1 code, h2 tt, h2 code, h3 tt, h3 code, h4 tt, h4 code, h5 tt, h5 code, h6 tt, h6 code {
font-size: inherit;
}

h1 {
font-size: 28px;
color: #000;
}

h2 {
font-size: 24px;
border-bottom: 1px solid #ccc;
color: #000;
}

h3 {
font-size: 18px;
}

h4 {
font-size: 16px;
}

h5 {
font-size: 14px;
}

h6 {
color: #777;
font-size: 14px;
}

body>h2:first-child, body>h1:first-child, body>h1:first-child+h2, body>h3:first-child, body>h4:first-child, body>h5:first-child, body>h6:first-child {
margin-top: 0;
padding-top: 0;
}

a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 {
margin-top: 0;
padding-top: 0;
}

h1+p, h2+p, h3+p, h4+p, h5+p, h6+p {
margin-top: 10px;
}

/* LINKS
=============================================================================*/

a {
color: #4183C4;
text-decoration: none;
}

a:hover {
text-decoration: underline;
}

/* LISTS
=============================================================================*/

ul, ol {
padding-left: 30px;
}

ul li > :first-child,
ol li > :first-child,
ul li ul:first-of-type,
ol li ol:first-of-type,
ul li ol:first-of-type,
ol li ul:first-of-type {
margin-top: 0px;
}

ul ul, ul ol, ol ol, ol ul {
margin-bottom: 0;
}

dl {
padding: 0;
}

dl dt {
font-size: 14px;
font-weight: bold;
font-style: italic;
padding: 0;
margin: 15px 0 5px;
}

dl dt:first-child {
padding: 0;
}

dl dt>:first-child {
margin-top: 0px;
}

dl dt>:last-child {
margin-bottom: 0px;
}

dl dd {
margin: 0 0 15px;
padding: 0 15px;
}

dl dd>:first-child {
margin-top: 0px;
}

dl dd>:last-child {
margin-bottom: 0px;
}

/* CODE
=============================================================================*/

pre, code, tt {
font-size: 12px;
font-family: Consolas, "Liberation Mono", Courier, monospace;
}

code, tt {
margin: 0 0px;
padding: 0px 0px;
white-space: nowrap;
border: 1px solid #eaeaea;
background-color: #f8f8f8;
border-radius: 3px;
}

pre>code {
margin: 0;
padding: 0;
white-space: pre;
border: none;
background: transparent;
}

pre {
background-color: #f8f8f8;
border: 1px solid #ccc;
font-size: 13px;
line-height: 19px;
overflow: auto;
padding: 6px 10px;
border-radius: 3px;
}

pre code, pre tt {
background-color: transparent;
border: none;
}

kbd {
-moz-border-bottom-colors: none;
-moz-border-left-colors: none;
-moz-border-right-colors: none;
-moz-border-top-colors: none;
background-color: #DDDDDD;
background-image: linear-gradient(#F1F1F1, #DDDDDD);
background-repeat: repeat-x;
border-color: #DDDDDD #CCCCCC #CCCCCC #DDDDDD;
border-image: none;
border-radius: 2px 2px 2px 2px;
border-style: solid;
border-width: 1px;
font-family: "Helvetica Neue",Helvetica,Arial,sans-serif;
line-height: 10px;
padding: 1px 4px;
}

/* QUOTES
=============================================================================*/

blockquote {
border-left: 4px solid #DDD;
padding: 0 15px;
color: #777;
}

blockquote>:first-child {
margin-top: 0px;
}

blockquote>:last-child {
margin-bottom: 0px;
}

/* HORIZONTAL RULES
=============================================================================*/

hr {
clear: both;
margin: 15px 0;
height: 0px;
overflow: hidden;
border: none;
background: transparent;
border-bottom: 4px solid #ddd;
padding: 0;
}

/* TABLES
=============================================================================*/

table th {
font-weight: bold;
}

table th, table td {
border: 1px solid #ccc;
padding: 6px 13px;
}

table tr {
border-top: 1px solid #ccc;
background-color: #fff;
}

table tr:nth-child(2n) {
background-color: #f8f8f8;
}

/* IMAGES
=============================================================================*/

img {
max-width: 100%
}
-->

Markdown语法说明

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。它的简单易用性使其成为一种适用于网络的书写语言。

Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。Markdown 的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

  • 本文大多数内容参考自 http://wowubuntu.com/markdown/#list 的文章,非常感谢来自 wowubuntu 的贡献。
  • 为了便于阅读学习,本文修改了一些章节的描述与顺序。
  • 本文全文都用Markdown进行编写,可见非常方便,易于发布。

如有您发现任何问题,欢迎提出。

目录

一、特性

  • 简单易用
    语法非常简单,只需要记住少量的标记就能够书写格式不错的文档。

  • 广泛性
    Markdown的使用非常广泛,因此它是一种非常通用的文档语言。

  • 兼容HTML
    不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。

注意:<div>、<table>、<pre>、<p>等标签必须在前后加上空行与其他内容隔开,并且开始与结束标签不能用空格或者制表符来缩进。另外,Markdown 语法在 HTML 区段标签间是有效的。

二、语法

从标记符号的使用方式划分,可以分为:

闭合标记符: 闭合标记符需要用两个(组)相同的符号将内容包裹,形成一个闭合才能起作用,如强调链接 等,一般不允许跨行。
开放标记符: 标记符只需要在开头使用,它会自动的作用于标记符后面的一行或多行内容。
特殊标记符: 一般用于引入特殊符号。

在Markdown中,绝大多数内容都用段落来进行组织。Markdown的语法里用一个空行来表示段落的结束:

第一个段落。

第二个段落。

如果需要在Markdown中对文本进行换行,只需要在前一行的最后加上两个空格,然后敲下回车即可。此效果等同于HTML中的<br/>

空行:只包含空白符号的行。
段落:类似于HTML中的<p>标签达到的效果。

2.1 闭合标记符

2.2.1 强调

Markdown使用型号(*)和下划线(_)来作为强调符号:

*斜体*
**粗体**
***粗斜体***

注意:如果(*)或者(_)两边都有空格的话,他们会被当作普通的符号。

你可以在文字之间使用强调符号。如果要在文字前后加上普通的星号,那么你需要在星号之前加上一个反斜杠。

\*这段话两边的星号是可以正常显示的。\*

2.1.2 代码块

如果要标记一小段行内代码,可以用反引号(`)或双反引号(``)将他们包裹起来:

像这样可以正常显示HTML的换行符的代码`<br/>`。

行内代码在绝大多数情况下能够正常显示在HTML中,因为它会以HTML能够显示的方式进行自动转码。

如果你的代码中包含一个反引号,你可以用双反引号让其正常显示:

代码中包含单个反引号 `` `这是我需要显示的内容` ``。

代码块不允许跨段落,但允许跨行:

`
这样是可以的
`

2.1.3 链接

Markdown支持三种形式的链接语法:行内式参考式自动链接

不论哪种,链接文字都用[方括号]来标记,后面紧跟用(括号)包裹起来的url链接地址。

可以在url的后面用空白字符加上 双引号单引号括号 包裹一个链接说明。

行内式
这是一个有说明文字的 [行内式](http://www.baidu.com "百度") 的例子。
这是一个没有说明文字的 [行内式](http://www.baidu.com) 的例子。

如果你需要链接到同一个主机的资源,可以用相对路径的形式:

这是一个引用 [相对路径](/relative) 的链接。
参考式

你可以用方括号紧跟冒号来定义一个不可见的链接标记:

[id]: http://www.baidu.com "百度"

在需要引用此链接时,在链接文字方括号的后面,用方括号接上链接的标记即可。

[百度] [id]

标记可以包含字母、数字和标点符号(甚至是空白符号),如果是字母,标记不会区分大小写。

还有一种隐式参考式链接语法,你可以省略链接标记当中的内容,Markdown会将标记认为与第一个括号中的内容相同。

[google]: http://www.google.com
这是 [google][] 的链接。

善用隐式参考式链接可以帮你节省很多工作量。

自动链接

自动链接用两个尖括号来包裹,并且要求内容符合链接地址或邮件地址的格式:

<http://www.baidu.com/>
<aquariuspj@foxmail.com>

它们会自动转换为如下形式:

<a href="http://www.baidu.com/">http://www.baidu.com/</a>
<a href="aquariuspj@foxmail.com">aquariuspj@foxmail.com</a>

事实上,Markdown会把邮件地址转化为16进制的HTML实体,以防止Email被一些技术含量较低的机器人爬取。

2.2 开放标记符

2.2.1 标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。

类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

# 这是 H1

## 这是 H2

###### 这是 H6

你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数)。

另外的,标题也允许使用类 Setext 形式:

This is an H1
============= This is an H2
-------------

= 表示一级标题, - 表示二级标题,任何数量的 = 和 - 都可以有效果。

2.2.2 列表

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记:

*   Red
* Green
* Blue

其中的星号可以替换为加号和减号,效果一毛一样。

有序列表则使用数字接着一个英文句点:

1.  Bird
2. McHale
3. Parish

一个容易混乱的地方在于,Markdown的输出格式和你在点号前面用的数字没有任何关系。下面这段有序列表和上面这段有着一模一样的输出效果:

8.  Bird
8. McHale
2. Parish

序号并不影响Markdown的顺序与输出,但我建议还是按顺序写,这样方便更清晰的查看源码。

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:

1.  This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit. 2. Suspendisse id sem consectetuer libero luctus adipiscing.

如果要在列表项目内放进引用,那 > 就需要缩进:

*   A list item with a blockquote:

    > This is a blockquote
> inside a list item.

如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:

*   一列表项包含一个列表区块:

        <代码写在这>

当然,项目列表很可能会不小心产生,像是下面这样的写法:

1986. What a great season.

换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。

1986\. What a great season.

2.2.3 区块引用 Blockquotes

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email 信件中的引言部分,你就知道怎么在 Markdown 文件中建立一个区块引用,那会看起来像是你自己先断好行,然后在每行的最前面加上 > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码:
>
> return shell_exec("echo $input | $markdown_script");

2.2.4 代码区块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用 <pre><code> 标签来把代码区块包起来。

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:

这是一个普通段落:

    这是一个代码区块。

Markdown 会转换成:

<p>这是一个普通段落:</p>

<pre><code>这是一个代码区块。
</code></pre>

一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。

在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,再加上缩进就可以了,剩下的 Markdown 都会帮你处理,例如:

    <div class="footer">
&copy; 2004 Foo Corporation
</div>

会被转换为:

<pre><code>&lt;div class="footer"&gt;
&amp;copy; 2004 Foo Corporation
&lt;/div&gt;
</code></pre>

代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。

2.3 特殊标记符

2.3.1 图片

Markdown 使用一种和链接很相似的语法来标记图片,同样允许两种样式:行内式参考式

行内式
[!替代文字](/path/img.jpg "说明")
参考式
[!替代文字] [id]
[id]: /path/img.jpg "说明"

到目前为止,Markdown还没有办法指定图片的宽高。如果你非要指定,那么只能用HTML的<img>标签。

2.3.2 分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

* * *

***

*****

- - -

---------------------------------------

2.3.3 反斜杠

Markdown 可以用反斜杠来插入一些在语法中有其它意义的符号:

\    反斜杠
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 圆括号
# 井号
+ 加号
- 减号
. 英文句点
! 惊叹号

2.3.4 版权符号

Markdown用一个很方便的办法来输出常用的版权符号 © ,只需要简单的 &copy; 即可。

三、感谢

本文大多数内容参考自 http://wowubuntu.com/markdown/#list 的文章,非常感谢来自 wowubuntu 的贡献。

本文为了便于阅读学习,修改了一些描述与顺序。

如有问题,欢迎提出。

[0]: #0
# <h1 id="0"> Markdown语法说明 </h1> Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。它的简单易用性使其成为一种适用于网络的书写语言。 Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。Markdown 的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。 * 本文大多数内容参考自 <http://wowubuntu.com/markdown/#list> 的文章,非常感谢来自 wowubuntu 的贡献。
* 为了便于阅读学习,本文修改了一些章节的描述与顺序。
* 本文全文都用Markdown进行编写,可见非常方便,易于发布。 如有您发现任何问题,欢迎提出。 ## 目录 * [一、特性](#1)
* [二、语法](#2)
* [2.1 闭合标记符](#2.1)
* [2.1.1 强调](#2.1.1)
* [2.1.2 代码块](#2.1.2)
* [2.1.3 链接](#2.1.3)
* [2.2 开放标记符](#2.2)
* [2.2.1 标题](#2.2.1)
* [2.2.2 列表](#2.2.2)
* [2.2.3 区块引用](#2.2.3)
* [2.2.4 代码区块](#2.2.4)
* [2.3 特殊标记符](#2.3)
* [2.3.1 图片](#2.3.1)
* [2.3.2 分割线](#2.3.2)
* [2.3.3 反斜杠](#2.3.3)
* [2.3.4 版权符号](#2.3.4)
* [三、感谢](#3) <h2 id="1"> 一、特性 </h2> * **简单易用**
语法非常简单,只需要记住少量的标记就能够书写格式不错的文档。 * **广泛性**
Markdown的使用非常广泛,因此它是一种非常通用的文档语言。 * **兼容HTML**
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。 > **注意:**`<div>、<table>、<pre>、<p>`等标签必须在前后加上空行与其他内容隔开,并且开始与结束标签不能用空格或者制表符来缩进。另外,Markdown 语法在 HTML 区段标签间是有效的。 <h2 id="2"> 二、语法 </h2> 从标记符号的使用方式划分,可以分为: > **闭合标记符:** 闭合标记符需要用两个(组)相同的符号将内容包裹,形成一个闭合才能起作用,如**强调** 、 **链接** 等,一般不允许跨行。
> **开放标记符:** 标记符只需要在开头使用,它会自动的作用于标记符后面的一行或多行内容。
> **特殊标记符:** 一般用于引入特殊符号。 在Markdown中,绝大多数内容都用段落来进行组织。Markdown的语法里用一个空行来表示段落的结束: 第一个段落。 第二个段落。 如果需要在Markdown中对文本进行换行,只需要在前一行的最后加上两个空格,然后敲下回车即可。此效果等同于HTML中的`<br/>`。 >**空行:**只包含空白符号的行。
>**段落:**类似于HTML中的`<p>`标签达到的效果。 ### <h3 id="2.1"> 2.1 闭合标记符 </h3> #### <h4 id="2.1.1"> 2.2.1 强调 </h4> Markdown使用型号(`*`)和下划线(`_`)来作为强调符号: *斜体*
**粗体**
***粗斜体*** > **注意**:如果(`*`)或者(`_`)两边都有空格的话,他们会被当作普通的符号。 你可以在文字之间使用强调符号。如果要在文字前后加上普通的星号,那么你需要在星号之前加上一个反斜杠。 \*这段话两边的星号是可以正常显示的。\* #### <h4 id="2.1.2"> 2.1.2 代码块 </h4> 如果要标记一小段行内代码,可以用反引号(`` ` ``)或双反引号(``)将他们包裹起来: 像这样可以正常显示HTML的换行符的代码`<br/>`。 行内代码在绝大多数情况下能够正常显示在HTML中,因为它会以HTML能够显示的方式进行自动转码。 如果你的代码中包含一个反引号,你可以用双反引号让其正常显示: 代码中包含单个反引号 `` `这是我需要显示的内容` ``。 代码块不允许跨段落,但允许跨行: `
这样是可以的
` #### <h4 id="2.1.3"> 2.1.3 链接 </h4> Markdown支持三种形式的链接语法:***行内式*** 、 ***参考式*** 、 ***自动链接***。 不论哪种,链接文字都用[方括号]来标记,后面紧跟用(括号)包裹起来的url链接地址。 > 可以在url的后面用空白字符加上 *双引号* 、 *单引号* 或 *括号* 包裹一个链接说明。 ##### 行内式 这是一个有说明文字的 [行内式](http://www.baidu.com "百度") 的例子。
这是一个没有说明文字的 [行内式](http://www.baidu.com) 的例子。 如果你需要链接到同一个主机的资源,可以用相对路径的形式: 这是一个引用 [相对路径](/relative) 的链接。 ##### 参考式 你可以用方括号紧跟冒号来定义一个不可见的链接标记: [id]: http://www.baidu.com "百度" 在需要引用此链接时,在链接文字方括号的后面,用方括号接上链接的标记即可。 [百度] [id] > 标记可以包含字母、数字和标点符号(甚至是空白符号),如果是字母,标记不会区分大小写。 还有一种隐式参考式链接语法,你可以省略链接标记当中的内容,Markdown会将标记认为与第一个括号中的内容相同。 [google]: http://www.google.com
这是 [google][] 的链接。 善用隐式参考式链接可以帮你节省很多工作量。 ##### 自动链接 自动链接用两个尖括号来包裹,并且要求内容符合链接地址或邮件地址的格式: <http://www.baidu.com/>
<aquariuspj@foxmail.com> 它们会自动转换为如下形式: <a href="http://www.baidu.com/">http://www.baidu.com/</a>
<a href="aquariuspj@foxmail.com">aquariuspj@foxmail.com</a> 事实上,Markdown会把邮件地址转化为16进制的HTML实体,以防止Email被一些技术含量较低的机器人爬取。 ### <h3 id="2.2"> 2.2 开放标记符 </h3> #### <h4 id="2.2.1"> 2.2.1 标题 </h4> Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。 类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如: # 这是 H1 ## 这是 H2 ###### 这是 H6 你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数)。 另外的,标题也允许使用类 Setext 形式: This is an H1
============= This is an H2
------------- = 表示一级标题, - 表示二级标题,任何数量的 = 和 - 都可以有效果。 #### <h4 id="2.2.2"> 2.2.2 列表 </h4> Markdown 支持有序列表和无序列表。 无序列表使用星号、加号或是减号作为列表标记: * Red
* Green
* Blue 其中的星号可以替换为加号和减号,效果一毛一样。 有序列表则使用数字接着一个英文句点: 1. Bird
2. McHale
3. Parish 一个容易混乱的地方在于,Markdown的输出格式和你在点号前面用的数字没有任何关系。下面这段有序列表和上面这段有着一模一样的输出效果: 8. Bird
8. McHale
2. Parish 序号并不影响Markdown的顺序与输出,但我建议还是按顺序写,这样方便更清晰的查看源码。 列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符: 1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit. 2. Suspendisse id sem consectetuer libero luctus adipiscing. 如果要在列表项目内放进引用,那 > 就需要缩进: * A list item with a blockquote: > This is a blockquote
> inside a list item. 如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符: * 一列表项包含一个列表区块: <代码写在这> 当然,项目列表很可能会不小心产生,像是下面这样的写法: 1986. What a great season. 换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。 1986\. What a great season. #### <h4 id="2.2.3"> 2.2.3 区块引用 Blockquotes </h4> Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email 信件中的引言部分,你就知道怎么在 Markdown 文件中建立一个区块引用,那会看起来像是你自己先断好行,然后在每行的最前面加上 > : > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing. Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > : > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing. 区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > : > This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level. 引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等: > ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码:
>
> return shell_exec("echo $input | $markdown_script"); #### <h4 id="2.2.4"> 2.2.4 代码区块 </h4> 和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用 `<pre>` 和 `<code>` 标签来把代码区块包起来。 要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入: 这是一个普通段落: 这是一个代码区块。 Markdown 会转换成: <p>这是一个普通段落:</p> <pre><code>这是一个代码区块。
</code></pre> 一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。 在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,再加上缩进就可以了,剩下的 Markdown 都会帮你处理,例如: <div class="footer">
&copy; 2004 Foo Corporation
</div> 会被转换为: <pre><code>&lt;div class="footer"&gt;
&amp;copy; 2004 Foo Corporation
&lt;/div&gt;
</code></pre> 代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。 ### <h3 id="2.3"> 2.3 特殊标记符 </h3> #### <h4 id="2.3.1"> 2.3.1 图片 </h4> Markdown 使用一种和链接很相似的语法来标记图片,同样允许两种样式:***行内式*** 和 ***参考式***。 ##### 行内式 [!替代文字](/path/img.jpg "说明") ##### 参考式 [!替代文字] [id]
[id]: /path/img.jpg "说明" 到目前为止,Markdown还没有办法指定图片的宽高。如果你非要指定,那么只能用HTML的`<img>`标签。 #### <h4 id="2.3.2"> 2.3.2 分割线 </h4> 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线: * * * *** ***** - - - --------------------------------------- #### <h4 id="2.3.3"> 2.3.3 反斜杠 </h4> Markdown 可以用反斜杠来插入一些在语法中有其它意义的符号: \ 反斜杠
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 圆括号
# 井号
+ 加号
- 减号
. 英文句点
! 惊叹号 #### <h4 id="2.3.4"> 2.3.4 版权符号 </h4> Markdown用一个很方便的办法来输出常用的版权符号 &copy; ,只需要简单的 `&copy;` 即可。 <h2 id="3"> 三、感谢 </h2> 本文大多数内容参考自 <http://wowubuntu.com/markdown/#list> 的文章,非常感谢来自 wowubuntu 的贡献。 本文为了便于阅读学习,修改了一些描述与顺序。 如有问题,欢迎提出。

本文的Markdown源码

Markdown简易语法说明的更多相关文章

  1. Markdown基本语法小结

    目录 Typore Markdown基本语法 1.标题 一级标题 二级标题 三级标题 2.字体加粗 3.斜体 4.文本高亮 5.上标 6.下标 7.引用代码 1 8.代码引用2 9.代码引用3 10. ...

  2. markdown常用语法总结

    转自markdown示例[模板] 1.1.段落标题 根据原文中的文档标题可以对应设置标题. # 一级标题## 二级标题### 三级标题 效果 => 一级标题 二级标题 三级标题 1.2.斜体.加 ...

  3. Markdown基本语法

    Markdown 基本语法记录 # 欢迎使用 Cmd Markdown 编辑阅读器 ------ 我们理解您需要更便捷更高效的工具记录思想,整理笔记.知识,并将其中承载的价值传播给他人,**Cmd M ...

  4. Markdown 简明语法手册

    Markdown 简明语法手册 本文原文http://www.jianshu.com/p/fdb5cbdaf244 根据个人使用情况有所修改. Markdown是一种轻量级标记语言,简称md.创始人为 ...

  5. Cmd Markdown 简明语法手册

    『Cmd 技术渲染的沙箱页面,点击此处编写自己的文档』 Cmd Markdown 简明语法手册 标签: Cmd-Markdown 1. 斜体和粗体 使用 * 和 ** 表示斜体和粗体. 示例: 这是 ...

  6. markdown简明语法

    # markdown简明语法 标签(空格分隔): markdown 本语法只涵盖了常用的内容 [toc] 标题 标题 标题 语法为: 根据需求 可以指定 不同大小的标题 # 顶级 ## 次级 ### ...

  7. 转 - markdown 简明语法

    Markdown是一种极简的『标记语言』,将文本转为HTML,通常为我大码农所用.其不追求大而全,简洁至上,正所谓不求最贵,只求最好! 本文介绍Markdown基本语法,内容很少,一行语法一行示例,学 ...

  8. 转: markdown基本语法

    Markdown 是一种轻量级标记语言,能将文本换成有效的XHTML(或者HTML)文档,它的目标是实现易读易写,成为一种适用于网络的书写语言. Markdown 语法简洁明了,易于掌握,所以用它来写 ...

  9. markdown 基础语法

    markdown 基础 你好,我是markdown文档 介绍 Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式. 说的简单一点,mar ...

随机推荐

  1. Vim的基本使用(二)

    本文为原创文章,转载请标明出处 目录 11.可视模式 12.指定计数 13.重复命令 14.外部命令 15.命令行编辑 16.文件编辑 17.分割窗口 18.GUI命令 19.配置 20.Vim Ch ...

  2. 【技巧】datagrid锁定列后重新加载时出现错位问题的解决

    [问题描述]:有时候datagrid设置了锁定列后,在重新加载datagrid数据时,出现锁定列与非锁定列数据错位的问题,如图: [问题分析]:查看css样式我们发现,锁定的列和非锁定的列属于两个不同 ...

  3. 富文本编辑器CKEditor的使用

    由于最近在架构一个pc端b/s结构的项目,项目中有个论坛模块,当用户发帖时,需要用到富文本编辑器,考虑了一下,决定使用CKEditor富文本编辑器,虽然现在问世的富文本编辑器很丰富,比如还有百度的UE ...

  4. HDU1423 LCIS

    1,先离散化,然后DP: 注意这个解法中,dp[i][j][k]代表a序列中前i个和b序列中前j个数结尾为k或小于k时的最大. 但是由于i是单增(一次1->n),而j反复变化(多次1->m ...

  5. Oracle 之——子查询 DDL DML 集合 及其他数据对象

    Oracle 学习笔记(二) 知识概要: 1.子查询 2.集合操作 3.DML语句操作 4.其他数据库对象 1.子查询 查询工资比SCOTT高的员工信息 1  select * 2  from emp ...

  6. es6零基础学习之构建脚本(二)

    编译器打开你的es6项目 首先:创建我们的第一个脚本,tasks/util/args.js      在文件里面要先引入一个包,处理命令行参数 import yargs from 'yargs'; / ...

  7. 批量下载验证码 shell

    #!/bin/sh seq 0 699 | xargs -i wget http://www.5184.com/gk/common/checkcode.php -O img/{}.png

  8. Linux系列教程(一)——Linux系统简介

    本系列教程将完整的讲解整个Linux相关的知识,这是楼主学完之后重新对Linux知识体系的整理.从最基础的知识开始,对于一个完全不懂Linux系统的人,相信在看完整个系列教程之后,都能对Linux有一 ...

  9. Servlet中路径信息总结

    ./ 当前目录 ../ 父级目录 / 根目录 资源寻找都是依靠路径,资源存储方式是按照哈希表运算的,所以路径的计算其实就是哈希值的计算. servlet中,所有路径的配置都要用绝对路径. 什么是绝对路 ...

  10. 关于时钟模块DS1302的使用心得

    最近在做万年历,用到实时时钟DS1302模块,花了两天时间看资料和写驱动,想记录一下我的学习经过,顺便做一下总结. 首先就是在图书馆查各种资料,于是查到的大多是这些,主要时硬件方面的资料: 其实能查到 ...