此文档用365体育网站,格式的震慑

概述

NOTE: This is Simplelified Chinese Edition Document of Markdown
Syntax. If you are seeking for English Edition Document. Please refer to
Markdown: Syntax.

宗旨

马克down 的靶子是达成「易读易写」。

可读性,无论如何,都是最重大的。壹份使用 马克down
格式撰写的文件应当能够一贯以纯文本文告,并且看起来不会像是由众多标签或者格式指令所构成。马克down
语法受到一些既有 text-to-HTML
格式的震慑,包涵 SetextatxTextilereStructuredTextGrutatext和 EtText,而最大灵感源于其实是纯文本电子邮件的格式。

总的说来, 马克down
的语法全由一些符号所结合,这一个标识经过精挑细选,其效劳一目精通。比方:在文字两旁加上星号,看起来就如*强调*。马克down
的列表看起来,嗯,正是列表。马克down
的区块引用看起来就真正像是引用1段文字,就好像你曾在电子邮件中见过的那样。

声明:
那份文书档案派生(fork)于复杂中文版,在此基础上进展了复杂转简体职业,并打开了适宜的点染。此文书档案用
马克down
语法编写,你能够到那边翻开它的源文件。「繁体普通话版的原本文件能够翻开那里
。」–By @riku / 本项目托管于
GitCafe

兼容 HTML

马克down 语法的对象是:成为1种适用于互联网的书写语言。

马克down 不是想要取代HTML,乃至也尚未要和它就像,它的语法种类很少,只对应 HTML
标识的一小部分。马克down 的构想不是要使得 HTML
文档更便于书写。以小编之见, HTML 已经很轻便写了。马克down
的见识是,能让文档更易于读、写和任意改。HTML
是1种发布的格式,Markdown 是一种书写的格式。就这么,马克down
的格式语法只含有纯文本能够包罗的范围。

不在 马克down 涵盖范围之内的竹签,都能够直接在文书档案里面用 HTML
撰写。不必要相当标注那是 HTML 或是 马克down;只要直接加标签就可以了。

要制约的惟有局地 HTML
区块成分――举例 <div><table><pre><p> 等标签,必须在内外加上空行与别的内容区隔断,还要求它们的起首标签与最终标签不能够用制表符或空格来缩进。马克down
的生成器有丰盛智能,不会在 HTML 区块标签外拉长不要求的<p> 标签。

事例如下,在 马克down 文件里拉长一段 HTML 表格:

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

请留心,在 HTML 区块标签间的 马克down 格式语法将不会被拍卖。比方,你在
HTML 区块Nelly用 马克down 样式的*强调*会未有功用。

HTML 的区段(行内)标签如 `、可以在 Markdown
的段落、列表或是标题里随意使用。依照个人习惯,甚至可以不用 Markdown
格式,而直接采用 HTML 标签来格式化。举例说明:如果比较喜欢 HTML
` 标签,能够一向动用那一个标签,而不用 马克down
提供的链接大概图像标签语法。

和处于 HTML 区块标签间分歧,马克down 语法在 HTML 区段标签间是可行的。

注: 本项目同时也托管于
Github 上,请通过
fork+pull request 格局来赞助立异本项目。

特殊字符自动转变

在 HTML
文件中,有多个字符供给相当管理: < 和 & 。 < 符号用于起初标签,& 符号则用来标志HTML
实体,假设你只是想要显示这一个字符的原型,你不可能不要接纳实体的样式,像是 &lt; 和 &amp;

& 字符特别让互联网文书档案编写者受折磨,若是您要打「AT&T
,你必须要写成「AT&amp;T」。而网址中的 & 字符也要改造。比方您要链接到:

http://images.google.com/images?num=30&q=larry+bird

你必需要把网站转变写为:

http://images.google.com/images?num=30&amp;q=larry+bird

技艺放开链接标签的 href 属性里。不用说也明白那很轻松忽视,那也大概是
HTML 规范查证所检查到的荒唐中,数量最多的。

马克down
让您能够自然地挥毫字符,须求改变的由它来管理好了。如若您使用的 & 字符是
HTML 字符实体的壹局地,它会保留原貌,不然它会被调换来 &amp;。

之所以您要是要在文书档案中插入三个版权符号 ©,你能够这么写:

&copy;

马克down 会保留它不动。而若你写:

AT&T

马克down 就会将它转为:

AT&amp;T

类似的景观也会产生在 < 符号上,因为 Markdown 允许 兼容
HTML
 ,假设你是把 < 符号作为
HTML 标签的定界符使用,那 Markdown 也不会对它做别的转变,不过1旦您写:

4 < 5

马克down 将会把它转换为:

4 &lt; 5

不过需求专注的是,code
范围内,不论是行内依然区块, < 和 & 五个标识都一定会被转变到 HTML
实体,那项特色让您能够很轻便地用 马克down 写 HTML code (和 HTML
相对来讲, HTML 语法中,你要把全体的 < 和 & 都调换为 HTML
实体,才具在 HTML 文件之中写出 HTML code。)


Markdown 语法表达 (简体中文版) / (点击查看飞速入门)


区块成分

概述

段落和换行

2个 马克down
段落是由一个或多个一连的文本行组成,它的左右要有1个之上的空行(空行的定义是体现上看起来像是空的,便会被视为空行。比如说,若某一行只包罗空格和制表符,则该行也会被视为空行)。普通段落不应该用空格或制表符来缩进。

「由3个或八个几次三番的文本行组成」那句话实际暗中提示了 马克down
允许段落内的紧逼换行(插入换行符),这几个特点和别的一大半的 text-to-HTML
格式不一样等(包罗 Movable Type 的「Convert Line
Breaks」选项),其余的格式会把每种换行符都转成 <br /> 标签。

如果你确实想要注重 Markdown
来插入 <br /> 标签的话,在插入处先按入多少个以上的空格然后回车。

确实,必要多费点事(多加空格)来发生 <br /> ,不过轻易地「每一种换行都改变为 <br />」的措施在
马克down 中并不切合, 马克down 中 email
式的 区块引用 和多段落的 列表 在接纳换行来排版的时候,不但更加好用,还更有益于阅读。

宗旨

马克down 的靶子是贯彻「易读易写」。

可读性,无论怎样,都以最要紧的。一份使用 马克down
格式撰写的公文应当能够一贯以纯文本公告,并且看起来不会像是由众多标签或然格式指令所组成。马克down
语法受到一些既有 text-to-HTML 格式的影响,包涵
365体育网站,SetextatxTextilereStructuredTextGrutatext

EtText,而最大灵感源于其实是纯文本电子邮件的格式。

总的说来, 马克down
的语法全由一些标识所构成,那一个标志经过精挑细选,其效劳一目掌握。比方:在文字两旁加上星号,看起来就像*强调*。Markdown
的列表看起来,嗯,就是列表。马克down
的区块引用看起来就着实像是引用一段文字,就如您曾在电子邮件中见过的那么。

标题

马克down
帮助二种标题的语法,类 Setext 和类 atx 形式。

类 Setext
情势是用底线的花样,利用 = (最高阶标题)和 - (第3阶标题),比如:

This is an H1
=============

This is an H2
-------------

任何数据的 = 和 - 都能够有效应。

类 Atx 情势则是在行首插入 1 到 陆 个 # ,对应到标题 壹 到 陆 阶,比方:

# 这是 H1

## 这是 H2

###### 这是 H6

您能够选拔性地「闭合」类 atx
样式的标题,那纯粹只是赏心悦目用的,假使认为这么看起来相比舒畅女士,你就能够在行尾加上 #,而行尾的# 数量也不用和开端同样(行首的井字符数量调控标题的阶数):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

兼容 HTML

马克down 语法的对象是:成为一种适用于互连网的书写语言。

马克down 不是想要代替HTML,以至也平昔不要和它好像,它的语法体系很少,只对应 HTML
标志的一小部分。马克down 的构想不是要使得 HTML
文书档案更易于书写。在笔者眼里, HTML 已经很轻便写了。马克down
的观点是,能让文书档案更易于读、写和随机改。HTML
是1种发布的格式,Markdown 是一种书写的格式。就那样,Markdown
的格式语法只包含纯文本能够分包的限量。

不在 Markdown 涵盖范围以内的竹签,都能够一直在文书档案里面用 HTML
撰写。不要求特出标注那是 HTML 或是 马克down;只要直接加标签就足以了。

要制裁的唯有1部分 HTML 区块成分――比方 <div><table><pre><p>
等标签,必须在左右加上空行与别的内容区隔断,还必要它们的起来标签与最后标签不可能用制表符或空格来缩进。马克down
的生成器有丰硕智能,不会在 HTML 区块标签外增进不要求的 <p> 标签。

事举例下,在 马克down 文件里丰富1段 HTML 表格:

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

请留心,在 HTML 区块标签间的 马克down 格式语法将不会被管理。举例,你在
HTML 区块内使用 马克down 样式的*强调*会并未有效能。

HTML 的区段(行内)标签如 `、可以在 Markdown
的段落、列表或是标题里随意使用。依照个人习惯,甚至可以不用 Markdown
格式,而直接采用 HTML 标签来格式化。举例说明:如果比较喜欢 HTML 的
` 标签,能够直接行使那么些标签,而不用 马克down
提供的链接恐怕图像标签语法。

和处于 HTML 区块标签间区别,马克down 语法在 HTML 区段标签间是行得通的。

区块引用 Blockquotes

Markdown 标识区块引用是使用类似 email
中用 > 的引用方式。假若你还熟习在 email
信件中的引言部分,你就精通怎么在 马克down
文件中确立多少个区块引用,那会看起来像是你和睦先断好行,然后在每行的最前边加上 > :

> 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.

马克down 也同意你偷懒只在全方位段落的率先行最前头加上 > :

> 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.

引用的区块内也得以采取任何的 马克down 语法,包蕴标题、列表、代码区块等:

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

任何像样的文件编辑器都能轻易地建立 email 型的引用。举例在 BB艾德it
中,你能够选拔文字后然后从选单中甄选充实引用阶层

特殊字符自动调换

在 HTML 文件中,有多少个字符须要新鲜管理: <&<
符号用于起首标签,& 符号则用来标志 HTML
实体,如若你只是想要呈现这一个字符的原型,你供给求使用实体的款式,像是
&lt;&amp;

& 字符尤其让网络文书档案编写者受折磨,要是你要打「AT&T
,你不能够不要写成「AT&amp;T」。而网站中的 &
字符也要改动。比方你要链接到:

http://images.google.com/images?num=30&q=larry+bird

你无法不要把网站转变写为:

http://images.google.com/images?num=30&amp;q=larry+bird

技巧放手链接标签的 href 属性里。不用说也清楚那很轻松忽视,那也说不定是
HTML 标准核查所检查到的荒谬中,数量最多的。

马克down 让您能够自然地挥毫字符,供给改变的由它来管理好了。即使你利用的
& 字符是 HTML 字符实体的一片段,它会保留原貌,不然它会被转变到
&amp;。

因此你如若要在文档中插入二个版权符号 ©,你可以这么写:

&copy;

马克down 会保留它不动。而若你写:

AT&T

马克down 就会将它转为:

AT&amp;T

看似的光景也会时有产生在 < 符号上,因为 Markdown 允许 兼容
HTML
,要是您是把 < 符号作为
HTML 标签的定界符使用,那 马克down 也不会对它做别的转变,可是若是您写:

4 < 5

马克down 将会把它转变为:

4 &lt; 5

不过供给留意的是,code 范围内,不论是行内依然区块, <&
三个暗记都一定会被转变来 HTML 实体,那项特色让你可以很轻松地用
马克down 写 HTML code (和 HTML 相对来说, HTML 语法中,你要把持有的 <
& 都调换为 HTML 实体,才能在 HTML 文件之中写出 HTML code。)


列表

马克down 支持有连串表和冬季列表。

冬辰列表使用星号、加号或是减号作为列表标志:

*   Red
*   Green
*   Blue

等同于:

+   Red
+   Green
+   Blue

也壹致:

-   Red
-   Green
-   Blue

1如既往列表则采用数字接着三个英文句点:

1.  Bird
2.  McHale
3.  Parish

很主要的一点是,你在列表标识上运用的数字并不会影响输出的 HTML
结果,下面的列表所产生的 HTML 标志为:

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

要是您的列表标志写成:

1.  Bird
1.  McHale
1.  Parish

或乃至是:

3. Bird
1. McHale
8. Parish

您都会获得完全同样的 HTML 输出。入眼在于,你能够让 马克down
文件的列表数字和输出的结果一致,或是你懒一点,你可以完全不用在意数字的没有错。

即便您使用懒惰的写法,提出首先个门类最佳可能从 一. 发轫,因为 马克down
今后说不定会协理有系列表的 start 属性。

列表项目的志经常是坐落最左边,可是事实上也足以缩进,最多 贰个空格,项目的志前边则必然要跟着至少三个空格或制表符。

要让列表看起来更美貌,你能够把内容用固定的缩进整理好:

*   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.

然则假使你懒,那也行:

*   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.

假使列表项目间用空行分开,在出口 HTML 时 马克down
就会将品种内容用 <p> 标签包起来,举个例子来说:

*   Bird
*   Magic

会被改变为:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

唯独那么些:

*   Bird

*   Magic

会被转变为:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

列表项目方可涵盖八个段落,各样门类下的段子都不可能不缩进 四 个空格或是 3个制表符:

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.

要是你每行都有缩进,看起来会入眼于许多,当然,再次地,即便您很懒惰,马克down
也同意:

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

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

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

只要要放代码区块的话,该区块就须要缩进两次,也正是 捌 个空格或是 一个制表符:

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

        <代码写在这>

自然,项目列表很也许会非常大心发生,像是上边那样的写法:

1986. What a great season.

换句话说,也正是在行首出现数字-句点-空白,要制止那样的光景,你能够在句点前边加上反斜杠。

1986\. What a great season.

区块成分

代码区块

和顺序相关的写作或是标签语言原始码平常会有已经排版好的代码区块,平时那几个区块我们并不期待它以一般段落文件的艺术去排版,而是照原来的轨范突显,马克down
会用 <pre> 和 <code> 标签来把代码区块包起来。

要在 马克down 中国建工总集团立代码区块很轻易,只要简单地缩进 四 个空格或是 三个制表符就足以,举例,上边包车型客车输入:

这是一个普通段落:

    这是一个代码区块。

Markdown 会调换来:

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

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

其1每行一阶的缩进(四 个空格或是 一 个制表符),都会被移除,举个例子:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

会被改造为:

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

三个代码区块会从来不停到未有缩进的那一行(或是文件结尾)。

在代码区块里面, & 、 < 和 > 会自动转成 HTML
实体,那样的法子让您13分轻易使用 马克down 插入表率用的 HTML
原始码,只须求复制贴上,再拉长缩进就能够了,剩下的 马克down
都会帮您管理,举个例子:

    <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>

代码区块中,一般的 马克down
语法不会被转换,像是星号便只是星号,那意味着你能够很轻巧地以 马克down
语法撰写 马克down 语法相关的文件。

段落和换行

三个 Markdown
段落是由一个或多少个延续的文本行组成,它的上下要有贰个以上的空行(空行的概念是显得上看起来像是空的,便会被视为空行。比如说,若某壹行只包蕴空格和制表符,则该行也会被视为空行)。普通段落不应当用空格或制表符来缩进。

「由2个或五个延续的文本行组成」这句话实际暗暗提示了 Markdown
允许段落内的逼迫换行(插入换行符),这么些性情和其他大多的 text-to-HTML
格式区别(包蕴 Movable Type 的「Convert Line
Breaks」选项),别的的格式会把各类换行符都转成 <br /> 标签。

如果你确实想要依赖 马克down 来插入 <br />
标签的话,在插入处先按入三个以上的空格然后回车。

确实,要求多费点事(多加空格)来发出 <br />
,可是简单地「每种换行都转移为 <br />」的措施在 马克down 中并不切合,
马克down 中 email 式的
区块引用 和多段落的
列表
在行使换行来排版的时候,不但越来越好用,还更利于阅读。

分隔线

你能够在壹行中用多个以上的星号、减号、底线来确立3个分隔线,行内不能够有此外东西。你也得以在星号或是减号中间插入空格。下边各个写法都能够成立分隔线:

* * *

***

*****

- - -

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

标题

马克down 协理三种标题的语法,类
Setext 和类
atx 形式。

类 Setext 方式是用底线的款型,利用 = (最高阶标题)和 -
(第二阶标题),举个例子:

This is an H1
=============

This is an H2
-------------

其余数据的 =- 都能够有意义。

类 Atx 方式则是在行首插入 一 到 陆 个 # ,对应到题目 1 到 陆 阶,比方:

# 这是 H1

## 这是 H2

###### 这是 H6

你能够选用性地「闭合」类 atx
样式的标题,那纯粹只是美观用的,倘使感觉这么看起来相比较舒适,你就能够在行尾加上
#,而行尾的 #
数量也不用和伊始同样(行首的井字符数量调节标题的阶数):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

区段成分

区块引用 Blockquotes

马克down 标志区块引用是行使类似 email 中用 >
的引用格局。倘使您还熟识在 email 信件中的引言部分,你就知道怎么在
Markdown
文件中确立2个区块引用,那会看起来像是你自个儿先断好行,然后在每行的最前头加上
>

> 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.

马克down 也同意你偷懒只在全部段落的首先行最前面加上 >

> 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.

引用的区块内也能够使用其余的 马克down 语法,包涵标题、列表、代码区块等:

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

其余类似的文本编辑器都能自在地确立 email 型的引用。举例在 BB艾德it
中,你能够挑选文字后然后从选单中选拔充实引用阶层

链接

马克down 帮衬二种样式的链接语法: 行内式参考式三种情势。

不论是是哪壹种,链接文字都以用 [方括号] 来标记。

要赤手空拳三个行内式的链接,只要在4方括号后边跟着圆括号并插入网站链接就可以,假如您还想要加上链接的
title 文字,只要在网站前边,用双引号把 title 文字包起来即可,举例:

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

[This link](http://example.net/) has no title attribute.

会产生:

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

只要你是要链接到同样主机的能源,你能够使用相对路线:

See my [About](/about/) page for details.

参考式的链接是在链接文字的括号后边再接上另贰个方括号,而在首个方括号内部要填写用以辨识链接的符号:

This is [an example][id] reference-style link.

您也能够选拔性地在三个方括号中间加上3个空格:

This is [an example] [id] reference-style link.

随即,在文书的大肆处,你能够把这些符号的链接内容定义出来:

[id]: http://example.com/  "Optional Title Here"

链接内容定义的方式为:

  • 方括号(前面能够选取性地加上至多五个空格来缩进),里面输入链接文字
  • 继而多个冒号
  • 进而一个之上的空格或制表符
  • 随之链接的网站
  • 选择性地接着 title 内容,能够用单引号、双引号或是括弧包着

上边那两种链接的概念都以一样:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

请注意:有二个已知的主题材料是 马克down.pl 一.0.一会忽略单引号包起来的链接 title。

链接网址也足以用方括号包起来:

[id]: <http://example.com/>  "Optional Title Here"

你也能够把 title
属性放到下壹行,也得以加一些缩进,若网址太长的话,那样会相比较赏心悦目:

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

网站定义唯有在产生链接的时候使用,并不会间接现身在文书之中。

链接辨别标签能够有字母、数字、空白和标点符号,但是并区分轻重缓急写,由此下边三个链接是1致的:

[link text][a]
[link text][A]

隐式链接标志职能让您能够简轻巧单钦定链接标志,那种情形下,链接标志会视为等同链接文字,要用隐式链接标志只要在链接文字前面加上二个空的方括号,假诺你要让
“谷歌” 链接到 google.com,你能够简化成:

[Google][]

然后定义链接内容:

[Google]: http://google.com/

是因为链接文字或者包罗空白,所以那种简化型的号子内大概包括七个单词:

Visit [Daring Fireball][] for more information.

接下来随即定义链接:

[Daring Fireball]: http://daringfireball.net/

链接的定义能够投身文件中的任何3个地点,笔者比较偏好直接放在链接出现段落的前边,你也足以把它身处文件最前边,就好像评释同样。

上面是二个参考式链接的表率:

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"

假如改成用链接名称的办法写:

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

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

地点三种写法都会生出上边的 HTML。

<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>

上边是用行内式写的同一一段内容的 马克down 文件,提供作为相比较之用:

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

参考式的链接其实重要不在于它相比好写,而是它相比较好读,比较一下地点的表率,使用参考式的小说小编唯有8一 个字符,不过用行内方式的却会加多到 17陆 个字元,假诺是用纯 HTML
格式来写,会有 23四 个字元,在 HTML 格式中,标签比文本还要多。

行使 Markdown
的参考式链接,可以让文件更像是浏览器最后发生的结果,让您能够把部分标志相关的元数据移到段落文字之外,你就足以追加链接而不让小说的开卷感到被打断。

列表

Markdown 匡助有系列表和冬日列表。

冬季列表使用星号、加号或是减号作为列表标志:

*   Red
*   Green
*   Blue

等同于:

+   Red
+   Green
+   Blue

也同等:

-   Red
-   Green
-   Blue

不改变列表则选取数字接着三个英文句点:

1.  Bird
2.  McHale
3.  Parish

很关键的一些是,你在列表标志上运用的数字并不会影响输出的 HTML
结果,上边的列表所产生的 HTML 标志为:

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

设若您的列表标识写成:

1.  Bird
1.  McHale
1.  Parish

或以致是:

3. Bird
1. McHale
8. Parish

您都会拿走完全一样的 HTML 输出。入眼在于,你能够让 马克down
文件的列表数字和出口的结果1律,或是你懒一点,你能够完全不用在意数字的没有错。

如若你采用懒惰的写法,建议首先个体系最佳仍然从 一. 起先,因为 马克down
今后也许会补助有体系表的 start 属性。

列表项目的志平时是身处最右边,可是其实也足以缩进,最多 3个空格,项目的志后边则必然要随着至少一个空格或制表符。

要让列表看起来更能够,你能够把内容用固定的缩进整理好:

*   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.

然则假若你懒,那也行:

*   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.

假若列表项目间用空行分开,在出口 HTML 时 马克down 就会将项目内容用 <p>
标签包起来,比如来讲:

*   Bird
*   Magic

会被调换为:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

而是这几个:

*   Bird

*   Magic

会被更改为:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

列表项目得以分包多个段子,每种种类下的段落都必须缩进 四 个空格或是 一个制表符:

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.

假定您每行都有缩进,看起来会看好繁多,当然,再度地,要是您很懒惰,Markdown
也同意:

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

1旦要在列表项目内放进引用,那 > 就须要缩进:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

假若要放代码区块的话,该区块就必要缩进两次,也正是 八 个空格或是 一个制表符:

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

        <代码写在这>

自然,项目列表很大概会相当的大心产生,像是下边那样的写法:

1986. What a great season.

换句话说,也正是在行首现身数字-句点-空白,要制止那样的风貌,你能够在句点前面加上反斜杠。

1986\. What a great season.

强调

马克down
使用星号(*)和底线(_)作为标识强调字词的符号,被 * 或 _ 包围的字词会被转成用 <em> 标签包围,用七个 * 或_ 包起来的话,则会被转成 <strong>,例如:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

会转成:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

您能够随便用你喜欢的体制,唯1的限定是,你用哪些符号开启标签,就要用什么样符号甘休。

重申也得以直接插在文字中间:

un*frigging*believable

但是假诺您的 * 和 _ 两边都有空白的话,它们就只会被当成普通的标志

举个例子要在文字前后直接插入普通的星号或底线,你能够用反斜线:

\*this text is surrounded by literal asterisks\*

代码区块

和顺序相关的编慕与著述或是标签语言原始码平日会有已经排版好的代码区块,常常这几个区块我们并不期望它以一般段落文件的办法去排版,而是照原来的样子呈现,Markdown
会用 <pre><code> 标签来把代码区块包起来。

要在 马克down 中制造代码区块很简短,只要轻松地缩进 四 个空格或是 一个制表符就足以,举个例子,上边包车型大巴输入:

这是一个普通段落:

    这是一个代码区块。

马克down 会转变来:

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

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

那几个每行1阶的缩进(肆 个空格或是 一 个制表符),都会被移除,例如:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

会被改换为:

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

三个代码区块会一贯不绝于耳到未有缩进的那一行(或是文件结尾)。

在代码区块里面, &<> 会自动转成 HTML
实体,那样的方式让您卓殊轻松使用 Markdown 插入模范用的 HTML
原始码,只要求复制贴上,再加上缩进就足以了,剩下的 马克down
都会帮你管理,比如:

    <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
语法不会被撤换,像是星号便只是星号,那代表您能够很轻松地以 马克down
语法撰写 马克down 语法相关的文件。

代码

假诺要标识一小段行内代码,你能够用反引号把它包起来(`),例如:

Use the `printf()` function.

会产生:

<p>Use the <code>printf()</code> function.</p>

如果要在代码区段内插入反引号,你能够用五个反引号来拉开和得了代码区段:

``There is a literal backtick (`) here.``

那段语法会发生:

<p><code>There is a literal backtick (`) here.</code></p>

代码区段的序幕和得了端都足以放入二个空手,起先端前边三个,甘休端后边多个,这样你就足以在区段的一齐来就插入反引号:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

会产生:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

在代码区段内,& 和方括号会被电动地转成 HTML 实体,那使得插入
HTML 原始码变得很轻松,马克down 会把下部那段:

Please don't use any `<blink>` tags.

转为:

<p>Please don't use any <code>&lt;blink&gt;</code> tags.</p>

你也能够这么写:

`&#8212;` is the decimal-encoded equivalent of `&mdash;`.

以产生:

<p><code>&amp;#8212;</code> is the decimal-encoded
equivalent of <code>&amp;mdash;</code>.</p>

分隔线

你能够在壹行中用三个以上的星号、减号、底线来建立三个分隔线,行内不能够有此外东西。你也足以在星号或是减号中间插入空格。上边每一种写法都得以建立分隔线:

* * *

***

*****

- - -

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

图片

很引人侧目地,要在纯文字应用中设计1个「自然」的语法来插入图片是有必然难度的。

马克down
使用1种和链接很相似的语法来标识图片,同样也允许两种样式: 行内式参考式

行内式的图纸语法看起来像是:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

详尽讲述如下:

  • 一个惊叹号 !
  • 继之三个方括号,里面放上海教室片的代表文字
  • 随之三个常备括号,里面放上海教室片的网站,最终还足以用引号包住并加上
    接纳性的 ‘title’ 文字。

参考式的图纸语法则长得像这么:

![Alt text][id]

「id」是图表参考的名号,图片参考的概念方式则和接通参考同样:

[id]: url/to/image  "Optional title attribute"

到近来停止, 马克down
还一向不艺术钦赐图片的宽高,倘若你需求的话,你能够应用普通的 <img> 标签。


区段元素

其它

链接

马克down 帮忙三种样式的链接语法: 行内式参考式三种样式。

甭管是哪壹种,链接文字都以用 [方括号] 来标记。

要树立一个行内式的链接,只要在肆方括号后边随着圆括号并插入网站链接就可以,若是你还想要加上链接的
title 文字,只要在网站前面,用双引号把 title 文字包起来就可以,举个例子:

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

[This link](http://example.net/) has no title attribute.

会产生:

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

1旦你是要链接到同样主机的财富,你能够应用相对路线:

See my [About](/about/) page for details.

参考式的链接是在链接文字的括号后边再接上另一个方括号,而在第3个方括号内部要填写用以辨识链接的符号:

This is [an example][id] reference-style link.

您也得以采纳性地在几个方括号中间加上三个空格:

This is [an example] [id] reference-style link.

跟着,在文书的放肆处,你能够把这么些符号的链接内容定义出来:

[id]: http://example.com/  "Optional Title Here"

链接内容定义的花样为:

  • 方括号(前边能够选拔性地抬高至多四个空格来缩进),里面输入链接文字
  • 继而2个冒号
  • 紧接着三个之上的空格或制表符
  • 随之链接的网站
  • 选取性地随着 title 内容,能够用单引号、双引号或是括弧包着

上边那两种链接的概念都是如出一辙:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

请注意:有贰个已知的题材是 Markdown.pl 一.0.一会忽略单引号包起来的链接 title。

链接网站也得以用方括号包起来:

[id]: <http://example.com/>  "Optional Title Here"

您也足以把 title
属性放到下1行,也足以加一些缩进,若网站太长的话,那样会相比较难堪:

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

网站定义唯有在发出链接的时候使用,并不会直接出现在文书之中。

链接辨别标签可以有字母、数字、空白和标点符号,不过并分别轻重缓急写,由此下边八个链接是均等的:

[link text][a]
[link text][A]

隐式链接标识功效让您可以差不离内定链接标志,那种景观下,链接标识会视为等同链接文字,要用隐式链接标志只要在链接文字后边加上一个空的方括号,假如您要让
“谷歌(Google)” 链接到 google.com,你能够简化成:

[Google][]

接下来定义链接内容:

[Google]: http://google.com/

由于链接文字大概含有空白,所以这种简化型的暗记内恐怕包括多少个单词:

Visit [Daring Fireball][] for more information.

下一场跟着定义链接:

[Daring Fireball]: http://daringfireball.net/

链接的概念能够放在文件中的任何一个地点,我相比偏好间接放在链接出现段落的末尾,你也得以把它座落文件最前边,就像注明一样。

上面是一个参考式链接的圭表:

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"

假使改成用链接名称的诀要写:

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

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

上边三种写法都会发生上面包车型客车 HTML。

<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>

上边是用行内式写的等同壹段内容的 马克down 文件,提供作为相比之用:

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

参考式的链接其实首要不在于它相比好写,而是它相比好读,相比一下地方的典范,使用参考式的小说笔者只有8一 个字符,不过用行内格局的却会加多到 17陆 个字元,假若是用纯 HTML
格式来写,会有 23四 个字元,在 HTML 格式中,标签比文本还要多。

行使 马克down
的参考式链接,能够让文件更像是浏览器最后发生的结果,让你能够把一些符号相关的元数据移到段落文字之外,你就足以追加链接而不让文章的读书感到被打断。

机关链接

Markdown
协理以比较简便的机动链接方式来管理网站和电子邮件信箱,只即使用方括号包起来,
马克down
就会自行把它转成链接。一般网站的链接文字就和链接地址一样,比如:

<http://example.com/>

Markdown 会转为:

<a href="http://example.com/">http://example.com/</a>

邮址的机关链接也很接近,只是 马克down
会先做三个编码调换的经过,把文字字符转成 1陆 进位码的 HTML
实体,那样的格式能够糊弄一些不好的邮址搜罗机器人,举个例子:

<address@example.com>

Markdown 会转成:

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

在浏览器里面,那段字串(其实是 <a href="mailto:address@example.com">address@example.com</a>)会成为2个方可点击的「address@example.com」链接。

(那种作法尽管可以糊弄不少的机器人,但并无法全体挡下来,可是总比什么都不搞好些。不管怎样,公开你的信箱终归会引来广告信件的。)

强调

马克down 使用星号(*)和底线(_)作为标识重申字词的号子,被 *
_ 包围的字词会被转成用 <em> 标签包围,用五个 *_
包起来的话,则会被转成 <strong>,例如:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

会转成:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

您能够任由用你喜欢的体裁,唯1的界定是,你用哪些符号开启标签,就要用哪些符号结束。

重申也足以间接插在文字中间:

un*frigging*believable

但是万1你的 *_
两边都有空白的话,它们就只会被当成普通的暗记

假使要在文字前后直接插入普通的星号或底线,你能够用反斜线:

\*this text is surrounded by literal asterisks\*

反斜杠

Markdown
能够运用反斜杠来插入一些在语法中有其余意义的标记,比方:如若你想要用星号加在文字旁边的不二等秘书籍来做出强调效果(但不用 <em> 标签),你可以在星号的前面加上反斜杠:

\*literal asterisks\*

马克down 帮忙以下这几个标记前面加上反斜杠来救助插入普通的暗号:

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

代码

要是要标识一小段行内代码,你能够用反引号把它包起来(`),例如:

Use the `printf()` function.

会产生:

<p>Use the <code>printf()</code> function.</p>

例如要在代码区段内插入反引号,你可以用八个反引号来打开和完工代码区段:

``There is a literal backtick (`) here.``

那段语法会产生:

<p><code>There is a literal backtick (`) here.</code></p>

代码区段的原初和终结端都足以放入二个空手,初叶端后面3个,截至端前面3个,那样你就足以在区段的1从头就插入反引号:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

会产生:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

在代码区段内,& 和方括号会被活动地转成 HTML 实体,这使得插入
HTML 原始码变得很轻易,马克down 会把下部那段:

Please don't use any `<blink>` tags.

转为:

<p>Please don't use any <code>&lt;blink&gt;</code> tags.</p>

你也足以如此写:

`&#8212;` is the decimal-encoded equivalent of `&mdash;`.

以产生:

<p><code>&amp;#8212;</code> is the decimal-encoded
equivalent of <code>&amp;mdash;</code>.</p>

感谢

感谢 leafy7382 扶助翻译,hlbRandylien 帮助润稿,ethantw 的汉字规范格式・CSS
Reset
, WM 回报文字错误。

感谢 fenpraceaddv

图片

很显眼地,要在纯文字应用中执会调查总计局筹1个「自然」的语法来插入图片是有必然难度的。

马克down 使用1种和链接很一般的语法来标志图片,相同也允许三种体裁:
行内式参考式

行内式的图纸语法看起来像是:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

详细描述如下:

  • 三个惊呆号 !
  • 进而叁个方括号,里面放上海教室片的代表文字
  • 随后二个惯常括号,里面放上海体育地方片的网站,最终还足以用引号包住并充分选择性的 ‘title’ 文字。

参考式的图片语法则长得像这么:

![Alt text][id]

「id」是图表参考的称号,图片参考的概念情势则和对接参考同样:

[id]: url/to/image  "Optional title attribute"

到近来甘休, 马克down
还未有办法钦点图片的宽高,要是您要求的话,你能够利用普通的 <img>
标签。


其它

机动链接

Markdown
辅助以相比较简略的机动链接方式来管理网址和电子邮件信箱,只假若用方括号包起来,
Markdown
就会活动把它转成链接。一般网址的链接文字就和链接地址同样,比如:

<http://example.com/>

Markdown 会转为:

<a href="http://example.com/">http://example.com/</a>

邮址的电动链接也很类似,只是 马克down
会先做三个编码转变的经过,把文字字符转成 1⑥ 进位码的 HTML
实体,那样的格式能够糊弄一些倒霉的邮址搜聚机器人,举个例子:

<address@example.com>

Markdown 会转成:

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

在浏览器里面,那段字串(其实是
<a href="mailto:address@example.com">address@example.com</a>)会成为三个得以点击的「address@example.com」链接。

(那种作法即使能够糊弄不少的机器人,但并无法1体挡下来,不过总比什么都不做好些。不管怎么样,公开你的邮箱终归会引来广告信件的。)

反斜杠

Markdown
能够动用反斜杠来插入一些在语法中有任何意义的标识,举例:要是你想要用星号加在文字旁边的章程来做出强调效果(但不用
<em> 标签),你能够在星号的前头加上反斜杠:

\*literal asterisks\*

马克down 帮忙以下这几个标识前边加上反斜杠来提携插入普通的符号:

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

感谢

感谢 leafy7382
扶助翻译,hlbRandylien
补助润稿,ethantw
汉字标准格式・CSS Reset
WM 回报文字错误。

感谢
fenpraceaddv


转自:http://wowubuntu.com/markdown/#editor

参考文书档案:http://www.ituring.com.cn/article/504\#

  人人能学会的极客语法Markdown登录web有道云笔记,从此码字如神

  http://mp.weixin.qq.com/s?\_\_biz=MjM5NjAyNjkwMA==&mid=472468102&idx=1&sn=cafff9a7629589dcde14b8b26f85a445&scene=21\#wechat\_redirect 

相关文章