365体育网站格式的影响。文章内容只是针对怎么迅速使Markdown写文本进行的阐释。

概述

Markdown

宗旨

Markdown 的对象是促成「易读易写」。

可读性,无论如何,都是最为重大之。一份使用 Markdown
格式撰写的文件应该可以直接以纯文本通告,并且看起不见面如是由众多标签或者格式指令所组成。Markdown
语法受到部分既来 text-to-HTML
格式的熏陶,包括 Setext、atx、Textile、reStructuredText、Grutatext和 EtText,而最特别灵感源于其实是纯粹文本电子邮件的格式。

总之, Markdown
的语法全由片号所结合,这些号经过精挑细选,其意图一目了然。比如:在文字两旁加上星号,看起就是比如*强调*。Markdown
的列表看起,嗯,就是列表。Markdown
的章引用看起就真正如是援一段子文字,就比如您既在电子邮件被见了之那么。

1. 兼容HTML

Markdown语法的对象是:成为平等种适用于网络的书语言。
Markdown的意是,能于文档更爱读、写及轻易变更。

  1. 一部分HTML区块元素必须于上下加上空行与另外内容区隔开,还要求开标签和终极标签不能够用制表符或空格来缩进。
  2. 当 HTML 区畈标签中的 Markdown 格式语法将无见面给处理
  3. HTML的区段(行内)标签可以在Markdown的段、列表或是标题里自由动用
  4. 暨远在HTML区块标签间不同,Markdown 语法在 HTML区段标签间是中的

兼容 HTML

Markdown 语法的目标是:成为同栽适用于网络的书写语言。

Markdown 不是纪念如果替代
HTML,甚至也远非使同其仿佛,它的语法种类特别少,只对诺 HTML
标记的相同不怎么片。Markdown 的构想不是如果教 HTML
文档更便于题。在我看来, HTML 已经颇容易写了。Markdown
的见解是,能于文档更易读、写及轻易改动。HTML
是同等种植发布的格式,Markdown 是一种书写的格式。就这么,Markdown
的格式语法只含有纯文本可以蕴涵的范围。

匪在 Markdown 涵盖范围里边的标签,都得一直当文档中所以 HTML
撰写。不欲额外标注这是 HTML 或是 Markdown;只要直接加标签就是好了。

如制裁的只有发生局部 HTML
区片元素――比如 <div><table><pre><p> 等标签,必须以上下加上空行与其它内容区隔开,还求它们的上马标签以及最终标签不能够用制表符或空格来缩进。Markdown
的生成器有足够智能,不会见以 HTML 区畈标签外增长不必要的<p> 标签。

事例如下,在 Markdown 文件里长同样段落 HTML 表格:

这是一个普通段落。

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

这是另一个普通段落。

伸手小心,在 HTML 区片标签内的 Markdown 格式语法将非会见于处理。比如,你当
HTML 区片内采取 Markdown 样式的*强调*会见没作用。

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

及处于 HTML 区块标签间不同,Markdown 语法在 HTML 区段标签间是行的。

2. 特殊字符自动转换

html中特有处理字符<和&,实体形式: <和&
想使显示这些字符的原型,必须使以实体的款型。
Markdown自动转换特殊字符,如果采用的&字符是HTML字符实体的同等片段,会保留原貌,否则会受转移成
&。

特殊字符自动转换

在 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 标准检验所检查及之荒谬中,数量最为多的。

Markdown
为您得当地挥毫字符,需要转移的是因为它们来处理好了。如果你下的 & 字符是
HTML 字符实体的如出一辙片段,它会保留生,否则其会被换成 &amp;。

从而你要是要于文档中插一个版权符号 ©,你可如此勾画:

&copy;

Markdown 会保留它不动。而一旦您勾勒:

AT&T

Markdown 就会拿其转为:

AT&amp;T

接近之景象呢会见产生在 < 符号上,因为 Markdown 允许 兼容
HTML ,如果您是将 < 符号作为
HTML 标签的定界符使用,那 Markdown 也未见面指向它举行任何移,但是只要您勾勒:

4 < 5

Markdown 将会管其换为:

4 &lt; 5

但需要注意的凡,code
范围外,不论是行内还是节, < 和 & 两独记都一定见面吃移成 HTML
实体,这项特色深受您可以老爱地用 Markdown 写 HTML code (和 HTML
相对而言, HTML 语法中,你如果把有的 < 和 & 都转换为 HTML
实体,才能够当 HTML 文件之中写来 HTML code。)


3. 区片元素
  1. 段落
    由于一个或者多独连续的文本行组成,它的左右要来一个以上的空行
  2. 换行
    栽<br />标签,在插入处先按适合鲜独以上之空格然后回车。
  3. 题语法
    少数栽标题语法

  4. Setext: 用底线形式,=(最高阶标题) -(第二流标题)

  5. atx: 行首安插入1届6单#,对诺标题1交6阶

  6. 章引用 >
    段引用得嵌套(例如:引用内的援),只要根据层次丰富不同数额之 >
    援的章内也得以以任何的 Markdown
    语法,包括标题、列表、代码区块等

  7. 列表
    无序列表 行首职使星号、加号和减号来举行吗列表的类标志
    产生序列表 行首使用相似的数字就一个英文句点作为项目标志

  8. 品种标志后虽然必然要是随着至少一个空格或制表符

  9. 每当类型里插入空行,那档之始末会就此<p>包起来
  10. 列表项目可分包多独段落,每个品种下之段子都不能不缩进 4 单空格或 1
    个制表符
  11. 于列表项目外放上引用,那 > 就得缩进
  12. 倘推广代码区块的话,该区块就需要缩进两不成,也就算是 8 独空格或 2
    个制表符:
  13. 以行首出现数字-句点-空白,要避这样的现象,可以当句点前面加上反斜杠。

  14. 代码区块
    建代码区块缩进4只空格或1独制表符。Markdown会为此<pre>和<code>标签来拿代码区块包起来

  15. 分隔线
    当一行中之所以三独以上的星号、减号、底线来树立一个分隔线。也足以在星号或是减号中间插空格

章元素

4. 区段元素
  1. 修辞和强调
    采用星号和下线连号需要强调的片
    斜体 *内容* 或者 _内容_
    加粗 **内容** 或者 __内容__
  2. 链接
    行内和参照两栽样式,链接文字用[方括号]来标记

  3. 行内
    方括号后圆括号内插入网址链接
    eg: This is an [example
    link](http://example.com/).
    title属性
    eg: [example
    link](http://example.com/
    “With a Title”).

  4. 参考
    每当链接文字的括号后面更搭上外一个方括号,在第二单方括号内部要填写用以辨识链接的号子
    eg:
    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)
    链接辨别标签可以起字母、数字、空白和标点符号,但是并无分轻重缓急写

  5. 图片
    好像链接,行内和参考两种植形式

  6. 行内
    ![alt text](/path/to/img.jpg “Title”)

  7. 参考
    ![alt text][id]
    [id]: /path/to/img.jpg “Title”

  8. 代码
    动用反引号 ` 来标记代码区段
    假设建立一个已经格式化好之代码区块,每行都缩进4个空格或一个tab。

  9. 其它

  10. 电动链接
    之所以尖括号包起来,Markdown就会见自行将它们改变成链接。一般网址的链接文字虽和链接地址一样。

  11. 反斜杠
    Markdown 可以利用反斜杠来插入一些于语法中发生外意义之标志
    \ 反斜线
    ` 反引号

  • 星号
    _ 底线
    {} 花括号
    [] 方括号
    () 括弧
    # 井字号

    • 加号
    • 减号
      . 英文句点
      ! 惊叹号

文章内容只是针对什么样快速利用Markdown写文本进行的阐发,如需要进行详细了解,请链接下面地址
Markdown

段与换行

一个 Markdown
段落是由一个或多只连续的文本行组成,它的光景要生一个以上之空行(空行的定义是显示上看起像是拖欠的,便会让视为空行。比方说,若有平执就含有空格和制表符,则该行也会于视为空行)。普通段落不该用空格或制表符来缩进。

「由一个要多独连续的文本行组成」这句话实际暗示了 Markdown
允许段落内之驱使换行(插入换行符),这个特性和其余多数的 text-to-HTML
格式不均等(包括 Movable Type 的「Convert Line
Breaks」选项),其它的格式会把每个换行符都转成 <br /> 标签。

如果你确实顾念使赖 Markdown
来插入 <br /> 标签的话,在插入处先按适合鲜只以上之空格然后回车。

的确,需要差不多花费点从(多加空格)来产生 <br /> ,但是简单地「每个换行都更换为 <br />」的办法在
Markdown 中连无入, Markdown 中 email
式的 章引用 和多段落的 列表 在运换行来排版的时,不但还好用,还更便于阅读。

标题

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

类 Setext
形式是因此底线的形式,利用 = (最高阶标题)和 - (第二品标题),例如:

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

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

任何数的 = 和 - 都可以生出效益。

类 Atx 形式则是以行首插入 1 到 6 单 # ,对诺到题目 1 到 6 阶,例如:

# 这是 H1

## 这是 H2

###### 这是 H6

君得选择性地「闭合」类 atx
样式的标题,这纯粹只是美观用的,若是觉得这么看起较舒适,你便足以于行尾加上 #,而行尾的# 数量也未用以及始发一样(行首的井字符数量控制标题的阶数):

# 这是 H1 #

## 这是 H2 ##

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

章引用 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");

外类似的文本编辑器都能轻松地成立 email 型的援。例如在 BBEdit
中,你得选文字后然后自选单中摘增加引用阶层

列表

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 输出。重点在于,你可以让 Markdown
文件之列表数字和输出的结果同样,或是你慵懒一点,你得完全不用当了数字之不易。

若是你用懒惰的写法,建议首先只类别不过好还是从 1. 开始,因为 Markdown
未来或者会见支撑有序列表的 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 时 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>

列表项目方可涵盖多单段落,每个类别下之段都得缩进 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.

比方你每行都发生缩进,看起会主很多,当然,再次地,如果你异常懒,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.

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

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

代码区块

同次序相关的作文或标签语言原始码通常会出就排版好的代码区块,通常这些章我们并无愿意它因为相似段落文件之主意去排版,而是照原来的榜样显示,Markdown
会为此 <pre> 和 <code> 标签来把代码区块包起来。

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

这是一个普通段落:

    这是一个代码区块。

Markdown 会转换成:

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

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

以此每行一阶段的缩进(4 个空格或 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
原始码,只需要复制粘贴上,再添加缩进就得了,剩下的 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 语法相关的文件。

分隔线

若得以一行中因故三个以上的星号、减号、底线来树立一个分隔线,行内不克生出其它东西。你吧足以当星号或是减号中间插空格。下面每种写法都好成立分隔线:

* * *

***

*****

- - -

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

区段元素

链接

Markdown 支持有限栽样式的链接语法: 行内式参考式少种形式。

无论是啊一样栽,链接文字还是故 [方括号] 来标记。

设若成立一个行内式的链接,只要在方括号后面跟着圆括号并插入网址链接即可,如果你还想只要加上链接的
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)

请注意:有一个业已知道的题材是 Markdown.pl 1.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]

隐式链接标记意义让您可以大概指定链接标记,这种情况下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面长一个拖欠的方括号,如果您如吃
“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>

脚是为此行内式写的平等一致截内容的 Markdown 文件,提供作为比的用:

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

参考式的链接其实主要不在她比好写,而是她比较好读,比较一下者的范例,使用参考式的稿子我就发生
81 单字符,但是之所以行内形式之可会增加及 176 独字元,如果是为此纯 HTML
格式来描写,会发出 234 单字元,在 HTML 格式中,标签比文本还要多。

动 Markdown
的参考式链接,可以于文件又如是浏览器最后有的结果,让你得管部分符号相关的首先数据易到段文字外,你尽管得多链接而无给文章的读感觉让于断。

强调

Markdown
用星号(*)和底线(_)作为标志强调字词的记号,被 * 或 _ 包围的字词会叫转移成用 <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\*

代码

一旦假定记一小段行内代码,你得据此反引号把其包起来(`),例如:

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 原始码变得好轻,Markdown 会把下部就段:

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>

图片

坏醒目地,要以纯文字应用被计划一个「自然」的语法来插入图片是发出肯定难度的。

Markdown
以相同种与链接很相像的语法来号图片,同样也同意两种植体裁: 行内式参考式

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

![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"

顶目前为止, Markdown
还无艺术指定图片的财大气粗高,如果你需要的话,你得应用普通的 <img> 标签。


其它

机动链接

Markdown
支持以较简便的电动链接形式来拍卖网址与电子邮件信箱,只要是为此方括号包起来,
Markdown
就会自行把她改变成链接。一般网址的链接文字虽与链接地址一样,例如:

<http://example.com/>

Markdown 会转为:

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

邮址的机动链接也杀接近,只是 Markdown
会先做一个编码转换的长河,把文字字符转成 16 进位码的 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」链接。

(这种作法虽然可以糊弄不少的机器人,但并无克一切挡住下,不过总比什么还无做好几。不管怎样,公开而的邮箱终究会引来广告信件的。)

反斜杠

Markdown
可以动用反斜杠来插入一些在语法中发出另外意义的标志,例如:如果您想要用星号加在文字旁边的不二法门来做出强调效益(但切莫用 <em> 标签),你得于星号的面前加上反斜杠:

\*literal asterisks\*

Markdown 支持以下这些号前面加上反斜杠来救助插入普通的标志:

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

感谢

感谢 leafy7382 协助翻译,hlb、Randylien 帮忙润稿,ethantw 的汉字标准格式・CSS
Reset, WM 回报文字错误。

感谢 fenprace,addv。

相关文章