格式的震慑。文章内容只是针对哪些快速利用Markdown写文本进行的阐发。

代码区块

与顺序相关的写作或标签语言原始码通常会产生一度排版好的代码区块,通常这些章我们并无期望她以相似段落文件的法门去排版,而是照原来的规范显示,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 语法相关的文书。

1. 兼容HTML

Markdown语法的靶子是:成为平等栽适用于网络的书写语言。
Markdown的见地是,能被文档更爱读、写及任性变动。

  1. 片HTML区块元素必须以左右加上空行与外内容区隔开,还求开标签及终极标签不可知用制表符或空格来缩进。
  2. 以 HTML 区畈标签内的 Markdown 格式语法将无见面受处理
  3. HTML的区段(行内)标签可以于Markdown的段、列表或是标题里随机动用
  4. 以及处于HTML区块标签间不同,Markdown 语法在 HTML区段标签间是实用的

回引用 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

图片

可怜显著地,要于纯文字应用被计划一个「自然」的语法来插入图片是生必然难度的。

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> 标签。


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

回元素

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. 分隔线
    于一行中之所以三独以上的星号、减号、底线来建一个分隔线。也堪在星号或是减号中间插空格

概述

2. 特殊字符自动转换

html中非常处理字符<和&,实体形式: <和&
想要展示这些字符的原型,必须要下实体的样式。
Markdown自动转换特殊字符,如果以的&字符是HTML字符实体的均等片,会保留原貌,否则会给换成为
&。

区段元素

段同换行

一个 Markdown
段落是由一个或者多单连续的文本行组成,它的上下要出一个之上的空行(空行的概念是亮上看起如是空的,便会叫视为空行。比方说,若有平等执仅包含空格和制表符,则该行也会见吃视为空行)。普通段落不拖欠用空格或制表符来缩进。

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

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

诚然,需要差不多消费点从(多加空格)来来 <br /> ,但是简单地「每个换行都更换为 <br />」的章程在
Markdown 中连无吻合, Markdown 中 email
式的 章引用 和多段落的 列表 在使换行来排版的时,不但更好用,还更便于阅读。

链接

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
的参考式链接,可以给文件再次像是浏览器最后出的结果,让你可以将有标志相关的状元数据易到段文字之外,你就可追加链接而不吃文章的读感觉让由断。

感谢

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

感谢 fenprace,addv。

自行链接

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> 标签包围,用有限个 * 或_ 包起来的话,则会于更改成 <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\*

其它

宗旨

Markdown 的目标是落实「易读易写」。

可读性,无论如何,都是绝要害的。一客使用 Markdown
格式撰写之公文应当可以直接为纯文本通告,并且看起不会见像是由于众多签或者格式指令所组成。Markdown
语法受到一些既来 text-to-HTML
格式的震慑,包括 Setext、atx、Textile、reStructuredText、Grutatext和 EtText,而最好深灵感来自其实是彻头彻尾文本电子邮件的格式。

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

标题

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

类似 Setext
形式是故底线的款型,利用 = (最高阶标题)和 - (第二流标题),例如:

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

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

外数之 = 和 - 都可以生出成效。

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

# 这是 H1

## 这是 H2

###### 这是 H6

乃可选择性地「闭合」类 atx
样式的标题,这纯粹只是美观用的,若是觉得这样看起比舒畅,你便足以当行尾加上 #,而行尾的# 数量为不用同始发一样(行首的井字符数量控制标题的阶数):

# 这是 H1 #

## 这是 H2 ##

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

列表

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.

特殊字符自动转换

于 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。)


代码

要假定记一多少段行内代码,你可用反引号把她包起来(`),例如:

Use the `printf()` function.

会产生:

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

倘只要以代码区段内插入反引号,你可以据此几近只反引号来开同了代码365体育备用网址区段:

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

分隔线

你可以于一行中之所以三独以上的星号、减号、底线来树一个分隔线,行内不能够发出其他东西。你呢得以于星号或是减号中间插空格。下面每种写法都得建立分隔线:

* * *

***

*****

- - -

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

兼容 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 区段标签间是可行之。

反斜杠

Markdown
可以应用反斜杠来插入一些在语法中发出外意义之标记,例如:如果你想如果因此星号加于文旁边的道来做出强调功能(但不用 <em> 标签),你可以于星号的眼前加上反斜杠:

\*literal asterisks\*

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

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

相关文章