1份使用 马克down,在此基础上进展了复杂转简体育赛职业

概述

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
的区块引用看起来就实在像是引用一段文字,就好像您曾在电子邮件中见过的那样。

声明:
那份文书档案派生(fork)于复杂中文版,在此基础上举办了复杂转简体育专科高校门的职业,并拓展了十分的润色。此文书档案用
马克down
语法编写,你能够到那边查阅它的源文件。「繁体中文版的原有文本能够查阅这里
。」–By @riku / 本项目托管于
GitCafe

兼容 HTML

马克down 语法的靶子是:成为一种适用于网络的书写语言。

马克down 不是想要取代HTML,乃至也并未有要和它相仿,它的语法连串很少,只对应 HTML
标志的一小部分。马克down 的构想不是要使得 HTML
文书档案更便于书写。在作者眼里, HTML 已经很轻易写了。马克down
的观点是,能让文书档案更易于读、写和随机改。HTML
是壹种发布的格式,Markdown 是一种书写的格式。就这么,马克down
的格式语法只包括纯文本能够涵盖的限定。

不在 Markdown 涵盖范围之内的价签,都得以直接在文书档案里面用 HTML
撰写。不必要万分标注那是 HTML 或是 马克down;只要直接加标签就足以了。

要制裁的唯有局地 HTML
区块成分――举例 <div><table><pre><p> 等标签,必须在前后加上空行与其他内容区隔断,还供给它们的早先标签与终极标签不可能用制表符或空格来缩进。马克down
的生成器有丰裕智能,不会在 HTML 区块标签外拉长不须求的<p> 标签。

事举个例子下,在 马克down 文件里增加一段 HTML 表格:

这是一个普通段落。

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

这是另一个普通段落。

请留心,在 HTML 区块标签间的 马克down 格式语法将不会被管理。举例,你在
HTML 区块内选用 马克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;。

故而你假诺要在文书档案中插入1个版权符号 ©,你能够如此写:

&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 语法表达 (简体汉语版) / (点击查看快捷入门)


区块成分

概述

段落和换行

3个 马克down
段落是由3个或七个两次三番的文本行组成,它的上下要有3个之上的空行(空行的定义是显得上看起来像是空的,便会被视为空行。比方说,若某一行只包罗空格和制表符,则该行也会被视为空行)。普通段落不应当用空格或制表符来缩进。

「由一个或三个一而再的文本行组成」那句话实际暗意了 马克down
允许段落内的强迫换行(插入换行符),这几个天性和其它好多的 text-to-HTML
格式分化样(包蕴 Movable Type 的「Convert Line
Breaks」选项),其余的格式会把种种换行符都转成 <br /> 标签。

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

真的,需求多费点事(多加空格)来发出 <br /> ,不过轻巧地「每一个换行都转移为 <br />」的措施在
马克down 中并不吻合, 马克down 中 email
式的 区块引用 和多段落的 列表 在采纳换行来排版的时候,不但更加好用,还更便利阅读。

宗旨

马克down 的靶子是实现「易读易写」。

可读性,无论怎么样,都以最重点的。一份使用 马克down
格式撰写的文书应当能够向来以纯文本文告,并且看起来不会像是由多数标签可能格式指令所构成。马克down
语法受到部分既有 text-to-HTML 格式的震慑,包涵
SetextatxTextilereStructuredTextGrutatext

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

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

标题

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

类 Setext
情势是用底线的款型,利用 = (最高阶标题)和 - (第一阶标题),举例:

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

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

别的数据的 = 和 - 都能够有效益。

类 Atx 格局则是在行首插入 壹 到 6 个 # ,对应到题目 壹 到 陆 阶,举个例子:

# 这是 H1

## 这是 H2

###### 这是 H6

您能够选取性地「闭合」类 atx
样式的标题,那纯粹只是雅观用的,假设感觉这么看起来相比较舒畅(Jennifer),你就能够在行尾加上 #,而行尾的# 数量也不用和早先一样(行首的井字符数量调节标题的阶数):

# 这是 H1 #

## 这是 H2 ##

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

兼容 HTML

Markdown 语法的目的是:成为一种适用于网络的书写语言。

马克down 不是想要代替HTML,乃至也平素不要和它就像是,它的语法连串很少,只对应 HTML
标志的一小部分。马克down 的构想不是要使得 HTML
文档更易于书写。以笔者之见, HTML 已经很轻易写了。马克down
的眼光是,能让文书档案更易于读、写和专断改。HTML
是壹种发布的格式,Markdown 是一种书写的格式。就这么,马克down
的格式语法只含有纯文本能够涵盖的限制。

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

要制约的唯有1部分 HTML 区块元素――举例 <div><table><pre><p>
等标签,必须在上下加上空行与其它内容区隔开分离,还供给它们的始发标签与终极标签不能够用制表符或空格来缩进。马克down
的生成器有丰裕智能,不会在 HTML 区块标签外增进不须求的 <p> 标签。

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

这是一个普通段落。

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

这是另一个普通段落。

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

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

和处于 HTML 区块标签间不相同,马克down 语法在 HTML 区段标签间是实惠的。

区块引用 Blockquotes

马克down 标志区块引用是选拔类似 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。)


列表

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
文件的列表数字和输出的结果一样,或是你懒一点,你能够完全不用在意数字的不利。

即便你选取懒惰的写法,建议首先个体系最佳还是从 一. 开始,因为 马克down
今后大概会支撑有体系表的 start 属性。

列表项目的识日常是位于最左侧,然则实际也足以缩进,最多 3个空格,项目的志前面则必然要随着至少2个空格或制表符。

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

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

设若您每行都有缩进,看起来会主持多数,当然,再一次地,假诺您很懒惰,马克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.

只要要放代码区块的话,该区块就须求缩进两次,相当于 捌 个空格或是 1个制表符:

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

        <代码写在这>

本来,项目列表相当大概会相当大心产生,像是上边这样的写法:

1986. What a great season.

换句话说,也等于在行首出现数字-句点-空白,要制止这样的处境,你能够在句点后面加上反斜杠。

1986\. What a great season.

区块成分

代码区块

和顺序相关的行文或是标签语言原始码平时会有曾经排版好的代码区块,平常那些区块大家并不愿意它以一般段落文件的章程去排版,而是照原来的模范展现,马克down
会用 <pre> 和 <code> 标签来把代码区块包起来。

要在 马克down 中国建工业总集合团立代码区块相当粗略,只要轻便地缩进 四 个空格或是 1个制表符就能够,比方,上面包车型地铁输入:

这是一个普通段落:

    这是一个代码区块。

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

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

在代码区块里面, & 、 < 和 > 会自动转成 HTML
实体,那样的主意让您卓殊轻便使用 马克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 语法相关的文件。

段落和换行

1个 Markdown
段落是由1个或多少个两次三番的文本行组成,它的光景要有一个上述的空行(空行的定义是展现上看起来像是空的,便会被视为空行。例如说,若某一行只含有空格和制表符,则该行也会被视为空行)。普通段落不应该用空格或制表符来缩进。

「由3个或四个延续的文本行组成」那句话实际暗中表示了 马克down
允许段落内的驱使换行(插入换行符),那几个特点和别的超越二分一的 text-to-HTML
格式分化(包含 Movable Type 的「Convert Line
Breaks」选项),其它的格式会把每种换行符都转成 <br /> 标签。

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

诚然,需求多费点事(多加空格)来发出 <br />
,不过轻松地「每种换行都更动为 <br />」的章程在 Markdown 中并不相符,
Markdown 中 email 式的
区块引用 和多段落的
列表
在接纳换行来排版的时候,不但更好用,还更便于阅读。

分隔线

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

* * *

***

*****

- - -

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

标题

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

类 Setext 方式是用底线的款式,利用 = (最高阶标题)和 -
(第三阶标题),比如:

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

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

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

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

# 这是 H1

## 这是 H2

###### 这是 H6

您可以选择性地「闭合」类 atx
样式的标题,那纯粹只是美观用的,假如以为这么看起来相比较舒适,你就能够在行尾加上
#,而行尾的 #
数量也不用和开端同样(行首的井字符数量调控标题的阶数):

# 这是 H1 #

## 这是 H2 ##

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

区段成分

区块引用 Blockquotes

马克down 标志区块引用是应用类似 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
中,你可以挑选文字后然后从选单中挑选扩大引用阶层

链接

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

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

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

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

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

您也足以选用性地在五个方括号中间加上一个空格:

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

紧接着,在文件的大四处,你能够把这一个标志的链接内容定义出来:

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

链接内容定义的样式为:

  • 方括号(前边能够选取性地丰裕至多七个空格来缩进),里面输入链接文字
  • 紧接着一个冒号
  • 进而3个之上的空格或制表符
  • 随即链接的网站
  • 选用性地接着 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.1会忽略单引号包起来的链接 title。

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

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

你也得以把 title
属性放到下一行,也足以加一些缩进,若网站太长的话,那样会相比较窘迫:

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

网址定义唯有在爆发链接的时候利用,并不会平昔出以后文件之中。

链接辨别标签可以有字母、数字、空白和标点符号,不过并区分轻重缓急写,由此上面四个链接是千篇一律的:

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

隐式链接标志意义让您能够简轻便单钦点链接标志,那种情况下,链接标识会视为等同链接文字,要用隐式链接标志只要在链接文字前面加上2个空的方括号,假诺您要让
“谷歌” 链接到 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>

上面是用行内式写的同1一段内容的 马克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
的参考式链接,能够让文件更像是浏览器最后发生的结果,让你能够把壹部分标识相关的元数据移到段落文字之外,你就可以扩张链接而不让文章的读书以为被打断。

列表

马克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
文件的列表数字和出口的结果1律,或是你懒一点,你能够完全不用在意数字的没有错。

比如您选择懒惰的写法,建议首先个品种最好依旧从 一. 起初,因为 马克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 时 Markdown 就会将项目内容用 <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.

设若你每行都有缩进,看起来会重点于很多,当然,再度地,假如您很懒惰,马克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
使用星号(*)和底线(_)作为标记重申字词的号子,被 * 或 _ 包围的字词会被转成用 <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>

你能够不管用你喜爱的样式,唯壹的限定是,你用哪些符号开启标签,就要用什么样符号停止。

重申也能够直接插在文字中间:

un*frigging*believable

但是借使你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的标识

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

\*this text is surrounded by literal asterisks\*

代码区块

和顺序相关的写作或是标签语言原始码平常会有曾经排版好的代码区块,日常这几个区块大家并不指望它以相似段落文件的主意去排版,而是照原来的旗帜展现,马克down
会用 <pre><code> 标签来把代码区块包起来。

要在 马克down 中树立代码区块很简短,只要简单地缩进 4 个空格或是 二个制表符就可以,举个例子,下边包车型地铁输入:

这是一个普通段落:

    这是一个代码区块。

马克down 会转变到:

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

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

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

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>

2个代码区块会平素不停到未有缩进的那1行(或是文件结尾)。

在代码区块里面, &<> 会自动转成 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>

代码区块中,一般的 马克down
语法不会被撤换,像是星号便只是星号,这象征您能够很轻巧地以 马克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>

代码区段的开场和了结端都能够放入二个空荡荡,伊始端前面三个,甘休端前边3个,那样你就足以在区段的壹从头就插入反引号:

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
使用壹种和链接很相似的语法来标志图片,同样也允许二种样式: 行内式参考式

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

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

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

详细描述如下:

  • 一个好奇号 !
  • 进而1个方括号,里面放上海体育地方片的代表文字
  • 随即叁个常常括号,里面放上海体育场所片的网站,最终还是能够用引号包住并累加
    选用性的 ‘title’ 文字。

参考式的图样语法则长得像那样:

![Alt text][id]

「id」是图片参考的名目,图片参考的定义格局则和连通参考一样:

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

到方今截至, 马克down
还尚未主意钦定图片的宽高,如果您要求的话,你能够动用普通的 <img> 标签。


区段成分

其它

链接

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

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

要创立叁个行内式的链接,只要在四方括号后面随着圆括号并插入网站链接就可以,借使你还想要加上链接的
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.

您也足以采纳性地在五个方括号中间加上贰个空格:

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)

请注意:有1个已知的主题素材是 马克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)” 链接到 google.com,你能够简化成:

[Google][]

下一场定义链接内容:

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

鉴于链接文字恐怕包涵空白,所以那种简化型的号子内恐怕包括多个单词:

Visit [Daring Fireball][] for more information.

然后紧接着定义链接:

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

链接的定义能够投身文件中的任何1个地方,笔者相比较偏好直接放在链接出现段落的背后,你也能够把它放在文件最末尾,就如评释同样。

上边是1个参考式链接的表率:

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>

上边是用行内式写的如出1辙一段内容的 马克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").

参考式的链接其实重要不在于它相比好写,而是它相比较好读,比较一下方面包车型客车典范,使用参考式的小说小编只有捌壹 个字符,但是用行内方式的却会增添到 176 个字元,若是是用纯 HTML
格式来写,会有 23四 个字元,在 HTML 格式中,标签比文本还要多。

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

机动链接

马克down
帮忙以比较简便的自行链接情势来拍卖网站和电子邮件信箱,只若是用方括号包起来,
Markdown
就会活动把它转成链接。一般网站的链接文字就和链接地址一样,比方:

<http://example.com/>

Markdown 会转为:

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

邮址的全自动链接也很相近,只是 马克down
会先做3个编码转变的历程,把文字字符转成 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>)会化为3个足以点击的「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>

您能够不管用你欢跃的体裁,唯一的限定是,你用什么样符号开启标签,就要用怎样符号截至。

重申也能够直接插在文字中间:

un*frigging*believable

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

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

\*this text is surrounded by literal asterisks\*

反斜杠

马克down
能够选用反斜杠来插入一些在语法中有别的意义的标识,比方:假使您想要用星号加在文字旁边的措施来做出重申成效(但不用 <em> 标签),你能够在星号的前面加上反斜杠:

\*literal asterisks\*

马克down 协助以下那些标识前面加上反斜杠来协助插入普通的号子:

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

代码

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

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>

代码区段的早先和终止端都得以放入一个空白,起头端前边一个,截止端后边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

图片

很通晓地,要在纯文字应用中布置3个「自然」的语法来插入图片是有断定难度的。

马克down 使用壹种和链接很相似的语法来标志图片,同样也允许二种体制:
行内式参考式

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

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

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

详细描述如下:

  • 1个好奇号 !
  • 随之多个方括号,里面放上海体育场面片的代表文字
  • 跟着三个一般性括号,里面放上海教室片的网站,最终还是能用引号包住并丰盛接纳性的 ‘title’ 文字。

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

![Alt text][id]

「id」是图片参考的名号,图片参考的定义情势则和接通参考一样:

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

到方今结束, Markdown
还平昔不艺术内定图片的宽高,假如你要求的话,你能够应用普通的 <img>
标签。


其它

机动链接

马克down
援助以比较简略的机动链接方式来管理网站和电子邮件信箱,只即使用方括号包起来,
马克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」链接。

(那种作法即使能够糊弄不少的机器人,但并无法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\#

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

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

相关文章