下載自：https://github.com/othree/markdown-syntax-zhtw

Markdown 文件

Markdown

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

Markdown: Syntax

• 概述
  • 哲學(xué)
  • 行內(nèi) HTML
  • 特殊字元自動轉(zhuǎn)換
• 區(qū)塊元素
  • 段落和換行
  • 標(biāo)題
  • 區(qū)塊引言
  • 清單
  • 程式碼區(qū)塊
  • 分隔線
• 區(qū)段元素
  • 連結(jié)
  • 強調(diào)
  • 程式碼
  • 圖片
• 其它
  • 跳脫字元
  • 自動連結(jié)
• 感謝

注意：這份文件是用 Markdown 寫的野宜，你可以看看它的原始檔 摘投。

<h2 id="overview">概述</h2>

<h3 id="philosophy">哲學(xué)</h3>

Markdown 的目標(biāo)是實現(xiàn)「易讀易寫」闰围。

不過最需要強調(diào)的便是它的可讀性。一份使用 Markdown 格式撰寫的文件應(yīng)該可以直接以純文字發(fā)佈，並且看起來不會像是由許多標(biāo)籤或是格式指令所構(gòu)成吮便。Markdown 語法受到一些既有 text-to-HTML 格式的影響贴膘，包括 Setext灵巧、atx拼弃、Textile夏伊、reStructuredText、Grutatext 和 EtText肴敛，然而最大靈感來源其實是純文字的電子郵件格式。

因此 Markdown 的語法全由標(biāo)點符號所組成吗购，並經(jīng)過嚴(yán)謹(jǐn)慎選医男，是為了讓它們看起來就像所要表達(dá)的意思。像是在文字兩旁加上星號捻勉，看起來就像*強調(diào)*镀梭。Markdown 的清單看起來，嗯踱启，就是清單报账。假如你有使用過電子郵件，區(qū)塊引言看起來就真的像是引用一段文字埠偿。

<h3 id="html">行內(nèi) HTML</h3>

Markdown 的語法有個主要的目的：用來作為一種網(wǎng)路內(nèi)容的寫作用語言透罢。

Markdown 不是要來取代 HTML，甚至也沒有要和它相似冠蒋，它的語法種類不多羽圃，只和 HTML 的一部分有關(guān)係，重點不是要創(chuàng)造一種更容易寫作 HTML 文件的語法抖剿，我認(rèn)為 HTML 已經(jīng)很容易寫了朽寞，Markdown 的重點在於，它能讓文件更容易閱讀斩郎、編寫脑融。HTML 是一種發(fā)佈的格式，Markdown 是一種編寫的格式缩宜，因此肘迎，Markdown 的格式語法只涵蓋純文字可以涵蓋的範(fàn)圍。

不在 Markdown 涵蓋範(fàn)圍之外的標(biāo)籤锻煌，都可以直接在文件裡面用 HTML 撰寫膜宋。不需要額外標(biāo)註這是 HTML 或是 Markdown；只要直接加標(biāo)籤就可以了炼幔。

只有區(qū)塊元素──比如 <div>秋茫、<table>、<pre>乃秀、<p> 等標(biāo)籤肛著，必須在前後加上空行圆兵，以利與內(nèi)容區(qū)隔。而且這些（元素）的開始與結(jié)尾標(biāo)籤枢贿，不可以用 tab 或是空白來縮排殉农。Markdown 的產(chǎn)生器有智慧型判斷，可以避免在區(qū)塊標(biāo)籤前後加上沒有必要的 <p> 標(biāo)籤局荚。

舉例來說超凳，在 Markdown 文件裡加上一段 HTML 表格：

This is a regular paragraph.

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

This is another regular paragraph.

請注意，Markdown 語法在 HTML 區(qū)塊標(biāo)籤中將不會被進行處理耀态。例如轮傍，你無法在 HTML 區(qū)塊內(nèi)使用 Markdown 形式的*強調(diào)*。

HTML 的區(qū)段標(biāo)籤如 <span>首装、<cite>创夜、<del> 則不受限制，可以在 Markdown 的段落仙逻、清單或是標(biāo)題裡任意使用驰吓。依照個人習(xí)慣，甚至可以不用Markdown 格式系奉，而採用 HTML 標(biāo)籤來格式化檬贰。舉例說明：如果比較喜歡 HTML 的 <a> 或 <img> 標(biāo)籤，可以直接使用這些標(biāo)籤缺亮，而不用 Markdown 提供的連結(jié)或是影像標(biāo)示語法偎蘸。

HTML 區(qū)段標(biāo)籤和區(qū)塊標(biāo)籤不同，在區(qū)段標(biāo)籤的範(fàn)圍內(nèi)瞬内， Markdown 的語法是有效的迷雪。

<h3 id="autoescape">特殊字元自動轉(zhuǎn)換</h3>

在 HTML 文件中，有兩個字元需要特殊處理： < 和 & 虫蝶。 < 符號用於起始標(biāo)籤章咧，& 符號則用於標(biāo)記 HTML 實體，如果你只是想要使用這些符號能真，你必須要使用實體的形式赁严，像是 < 和 &。

& 符號其實很容易讓寫作網(wǎng)路文件的人感到困擾粉铐，如果你要打「AT&T」 疼约，你必須要寫成「AT&T」 ，還得轉(zhuǎn)換網(wǎng)址內(nèi)的 & 符號蝙泼，如果你要連結(jié)到：

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

你必須要把網(wǎng)址轉(zhuǎn)成：

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

才能放到連結(jié)標(biāo)籤的 href 屬性裡程剥。不用說也知道這很容易忘記，這也可能是 HTML 標(biāo)準(zhǔn)檢查所檢查到的錯誤中汤踏，數(shù)量最多的织鲸。

Markdown 允許你直接使用這些符號舔腾，但是你要小心跳脫字元的使用，如果你是在HTML 實體中使用 & 符號的話搂擦，它不會被轉(zhuǎn)換稳诚，而在其它情形下，它則會被轉(zhuǎn)換成 &瀑踢。所以你如果要在文件中插入一個著作權(quán)的符號扳还，你可以這樣寫：

?

Markdown 將不會對這段文字做修改，但是如果你這樣寫：

AT&T

Markdown 就會將它轉(zhuǎn)為：

AT&T

類似的狀況也會發(fā)生在 < 符號上橱夭，因為 Markdown 支援 行內(nèi) HTML 氨距，如果你是使用 < 符號作為 HTML 標(biāo)籤使用，那 Markdown 也不會對它做任何轉(zhuǎn)換徘钥，但是如果你是寫：

4 < 5

Markdown 將會把它轉(zhuǎn)換為：

4 < 5

不過需要注意的是衔蹲，code 範(fàn)圍內(nèi)肢娘，不論是行內(nèi)還是區(qū)塊呈础， < 和 & 兩個符號都一定會被轉(zhuǎn)換成 HTML 實體，這項特性讓你可以很容易地用 Markdown 寫 HTML code （和 HTML 相對而言橱健， HTML 語法中而钞，你要把所有的 < 和 & 都轉(zhuǎn)換為 HTML 實體，才能在 HTML 文件裡面寫出 HTML code拘荡。）

<h2 id="block">區(qū)塊元素</h2>

<h3 id="p">段落和換行</h3>

一個段落是由一個以上相連接的行句組成臼节，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，便會被視為空行珊皿。比方說网缝，若某一行只包含空白和 tab，則該行也會被視為空行）蟋定，一般的段落不需要用空白或斷行縮排粉臊。

「一個以上相連接的行句組成」這句話其實暗示了 Markdown 允許段落內(nèi)的強迫斷行，這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的「Convert Line Breaks」選項）驶兜，其它的格式會把每個斷行都轉(zhuǎn)成 <br /> 標(biāo)籤扼仲。

如果你真的想要插入 <br /> 標(biāo)籤的話，在行尾加上兩個以上的空白抄淑，然後按 enter屠凶。

是的，這確實需要花比較多功夫來插入 <br /> 肆资，但是「每個換行都轉(zhuǎn)換為 <br />」的方法在 Markdown 中並不適合矗愧， Markdown 中 email 式的 區(qū)塊引言 和多段落的 清單 在使用換行來排版的時候，不但更好用郑原，還更好閱讀贱枣。

<h3 id="header">標(biāo)題</h3>

Markdown 支援兩種標(biāo)題的語法监署，Setext 和 atx 形式。

Setext 形式是用底線的形式纽哥，利用 = （最高階標(biāo)題）和 - （第二階標(biāo)題）钠乏，例如：

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

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

任何數(shù)量的 = 和 - 都可以有效果。

Atx 形式則是在行首插入 1 到 6 個 # 春塌，對應(yīng)到標(biāo)題 1 到 6 階晓避，例如：

# This is an H1

## This is an H2

###### This is an H6

你可以選擇性地「關(guān)閉」atx 樣式的標(biāo)題，這純粹只是美觀用的只壳，若是覺得這樣看起來比較舒適俏拱，你就可以在行尾加上 #，而行尾的 # 數(shù)量也不用和開頭一樣（行首的井字?jǐn)?shù)量決定標(biāo)題的階數(shù)）：

# This is an H1 #

## This is an H2 ##

### This is an H3 ######

<h3 id="blockquote">Blockquotes</h3>

Markdown 使用 email 形式的區(qū)塊引言吼句，如果你很熟悉如何在 email 信件中引言锅必，你就知道怎麼在 Markdown 文件中建立一個區(qū)塊引言，那會看起來像是你強迫斷行惕艳，然後在每行的最前面加上 > ：

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

區(qū)塊引言可以有階層（例如：引言內(nèi)的引言）搞隐，只要根據(jù)層數(shù)加上不同數(shù)量的 > ：

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

引言的區(qū)塊內(nèi)也可以使用其他的 Markdown 語法，包括標(biāo)題远搪、清單劣纲、程式碼區(qū)塊等：

> ## This is a header.
> 
> 1.   This is the first list item.
> 2.   This is the second list item.
> 
> Here's some example code:
> 
>     return shell_exec("echo $input | $markdown_script");

任何標(biāo)準(zhǔn)的文字編輯器都能簡單地建立 email 樣式的引言，例如 BBEdit 谁鳍，你可以選取文字後然後從選單中選擇增加引言階層癞季。

<h3 id="list">清單</h3>

Markdown 支援有序清單和無序清單。

無序清單使用星號倘潜、加號或是減號作為清單標(biāo)記：

*   Red
*   Green
*   Blue

等同於：

+   Red
+   Green
+   Blue

也等同於：

-   Red
-   Green
-   Blue

有序清單則使用數(shù)字接著一個英文句點：

1.  Bird
2.  McHale
3.  Parish

很重要的一點是绷柒，你在清單標(biāo)記上使用的數(shù)字並不會影響輸出的 HTML 結(jié)果，上面的清單所產(chǎn)生的 HTML 標(biāo)記為：

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

如果你的清單標(biāo)記寫成：

1.  Bird
1.  McHale
1.  Parish

或甚至是：

3. Bird
1. McHale
8. Parish

你都會得到完全相同的 HTML 輸出涮因。重點在於废睦，你可以讓 Markdown 文件的清單數(shù)字和輸出的結(jié)果相同，或是你懶一點蕊退，你可以完全不用在意數(shù)字的正確性郊楣。

如果你使用懶惰的寫法，建議第一個項目最好還是從 1. 開始瓤荔，因為 Markdown 未來可能會支援有序清單的 start 屬性净蚤。

清單項目標(biāo)記通常是放在最左邊，但是其實也可以縮排输硝，最多三個空白今瀑，項目標(biāo)記後面則一定要接著至少一個空白或 tab。

要讓清單看起來更漂亮，你可以把內(nèi)容用固定的縮排整理好：

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

如果清單項目間用空行分開屿附， Markdown 會把項目的內(nèi)容在輸出時用 <p>
標(biāo)籤包起來，舉例來說：

*   Bird
*   Magic

會被轉(zhuǎn)換為：

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

但是這個：

*   Bird

*   Magic

會被轉(zhuǎn)換為：

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

清單項目可以包含多個段落哥童，每個項目下的段落都必須縮排 4 個空白或是一個 tab ：

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.

如果你每行都有縮排挺份，看起來會看好很多，當(dāng)然贮懈，再次地匀泊，如果你很懶惰，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.

如果要在清單項目內(nèi)放進引言朵你，那 > 就需要縮排：

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

如果要放程式碼區(qū)塊的話例诀，該區(qū)塊就需要縮排兩次澈蟆，也就是 8 個空白或是兩個 tab：

*   A list item with a code block:

        <code goes here>

當(dāng)然堕仔，項目清單很可能會不小心產(chǎn)生蔑祟，像是下面這樣的寫法：

1986. What a great season.

換句話說，也就是在行首出現(xiàn)數(shù)字-句點-空白忌傻，要避免這樣的狀況大脉，你可以在句點前面加上反斜線。

1986\. What a great season.

<h3 id="precode">程式碼區(qū)塊</h3>

和程式相關(guān)的寫作或是標(biāo)籤語言原始碼通常會有已經(jīng)排版好的程式碼區(qū)塊芯勘，通常這些區(qū)塊我們並不希望它以一般段落文件的方式去排版箱靴，而是照原來的樣子顯示荷愕，Markdown 會用 <pre> 和 <code> 標(biāo)籤來把程式碼區(qū)塊包起來安疗。

要在 Markdown 中建立程式碼區(qū)塊很簡單，只要簡單地縮排 4 個空白或是 1 個 tab 就可以玉罐，例如吊输，下面的輸入：

This is a normal paragraph:

    This is a code block.

Markdown 會轉(zhuǎn)換成：

<p>This is a normal paragraph:</p>

<pre><code>This is a code block.
</code></pre>

這個每行一階的縮排（4 個空白或是 1 個 tab）季蚂，都會被移除算谈，例如：

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

會被轉(zhuǎn)換為：

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

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

一個程式碼區(qū)塊會一直持續(xù)到?jīng)]有縮排的那一行（或是文件結(jié)尾）然眼。

在程式碼區(qū)塊裡面葵腹， & 罪治、 < 和 > 會自動轉(zhuǎn)成 HTML 實體，這樣的方式讓你非常容易使用 Markdown 插入範(fàn)例用的 HTML 原始碼礁蔗，只需要複製貼上觉义，再加上縮排就可以了，剩下的 Markdown 都會幫你處理浴井，例如：

    <div class="footer">
        ? 2004 Foo Corporation
    </div>

會被轉(zhuǎn)換為：

<pre><code><div class="footer">
    ? 2004 Foo Corporation
</div>
</code></pre>

程式碼區(qū)塊中晒骇，一般的 Markdown 語法不會被轉(zhuǎn)換磺浙，像是星號便只是星號，這表示你可以很容易地以 Markdown 語法撰寫 Markdown 語法相關(guān)的文件瘤缩。

<h3 id="hr">分隔線</h3>

你可以在一行中用三個或以上的星號、減號剥啤、底線來建立一個分隔線，行內(nèi)不能有其他東西不脯。你也可以在星號中間插入空白府怯。下面每種寫法都可以建立分隔線：

* * *

***

*****

- - -

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

<h2 id="span">區(qū)段元素</h2>

<h3 id="link">連結(jié)</h3>

Markdown 支援兩種形式的連結(jié)語法： 行內(nèi)和參考兩種形式。

不管是哪一種防楷，連結(jié)的文字都是用 [方括號] 來標(biāo)記牺丙。

要建立一個行內(nèi)形式的連結(jié)亿昏，只要在方塊括號後面馬上接著括號並插入網(wǎng)址連結(jié)即可，如果你還想要加上連結(jié)的 title 文字，只要在網(wǎng)址後面，用雙引號把 title 文字包起來即可冀墨，例如：

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

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

會產(chǎn)生：

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

<p><a >This link</a> has no
title attribute.</p>

如果你是要連結(jié)到同樣主機的資源虫腋，你可以使用相對路徑：

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

參考形式的連結(jié)使用另外一個方括號接在連結(jié)文字的括號後面踏烙，而在第二個方括號裡面要填入用以辨識連結(jié)的標(biāo)籤：

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

你也可以選擇性地在兩個方括號中間加上空白：

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

接著，在文件的任意處，你可以把這個標(biāo)籤的連結(jié)內(nèi)容定義出來：

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

連結(jié)定義的形式為：

• 方括號农渊，裡面輸入連結(jié)的辨識用標(biāo)籤
• 接著一個冒號
• 接著一個以上的空白或 tab
• 接著連結(jié)的網(wǎng)址
• 選擇性地接著 title 內(nèi)容，可以用單引號、雙引號或是括弧包著

下面這三種連結(jié)的定義都是相同：

[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 會忽略單引號包起來的連結(jié) title传于。

連結(jié)網(wǎng)址也可以用方括號包起來：

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

你也可以把 title 屬性放到下一行囱挑，也可以加一些縮排，網(wǎng)址太長的話沼溜，這樣會比較好看：

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

網(wǎng)址定義只有在產(chǎn)生連結(jié)的時候用到平挑，並不會直接出現(xiàn)在文件之中。

連結(jié)辨識標(biāo)籤可以有字母、數(shù)字找都、空白和標(biāo)點符號唇辨，但是並不區(qū)分大小寫，因此下面兩個連結(jié)是一樣的：

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

預(yù)設(shè)的連結(jié)標(biāo)籤功能讓你可以省略指定連結(jié)標(biāo)籤能耻，這種情形下助泽，連結(jié)標(biāo)籤和連結(jié)文字會視為相同，要用預(yù)設(shè)連結(jié)標(biāo)籤只要在連結(jié)文字後面加上一個空的方括號嚎京，如果你要讓 "Google" 連結(jié)到 google.com嗡贺，你可以簡化成：

[Google][]

然後定義連結(jié)內(nèi)容：

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

由於連結(jié)文字可能包含空白，所以這種簡化的標(biāo)籤內(nèi)也可以包含多個文字：

Visit [Daring Fireball][] for more information.

然後接著定義連結(jié)：

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

連結(jié)的定義可以放在文件中的任何一個地方鞍帝，我比較偏好直接放在連結(jié)出現(xiàn)段落的後面诫睬，你也可以把它放在文件最後面，就像是註解一樣帕涌。

下面是一個參考式連結(jié)的範(fàn)例：

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"

如果改成用連結(jié)名稱的方式寫：

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"

上面兩種寫法都會產(chǎn)生下面的 HTML摄凡。

<p>I get 10 times more traffic from <a 
title="Google">Google</a> than from
<a  title="Yahoo Search">Yahoo</a>
or <a  title="MSN Search">MSN</a>.</p>

下面是用行內(nèi)形式寫的同樣一段內(nèi)容的 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").

參考式的連結(jié)其實重點不在於它比較好寫蚓曼，而是它比較好讀亲澡，比較一下上面的範(fàn)例，使用參考式的文章本身只有 81 個字元纫版，但是用行內(nèi)形式的連結(jié)卻會增加到 176 個字元床绪，如果是用純 HTML 格式來寫，會有 234 個字元其弊，在 HTML 格式中癞己，標(biāo)籤比文字還要多。

使用 Markdown 的參考式連結(jié)梭伐，可以讓文件更像是瀏覽器最後產(chǎn)生的結(jié)果痹雅，讓你可以把一些標(biāo)記相關(guān)的資訊移到段落文字之外，你就可以增加連結(jié)而不讓文章的閱讀感覺被打斷糊识。

<h3 id="em">強調(diào)</h3>

Markdown 使用星號（*）和底線（_）作為標(biāo)記強調(diào)字詞的符號绩社，被 * 或 _ 包圍的字詞會被轉(zhuǎn)成用 <em> 標(biāo)籤包圍摔蓝，用兩個 * 或 _ 包起來的話，則會被轉(zhuǎn)成 <strong>愉耙，例如：

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

會轉(zhuǎn)成：

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

你可以隨便用你喜歡的樣式项鬼，唯一的限制是，你用什麼符號開啟標(biāo)籤劲阎，就要用什麼符號結(jié)束绘盟。

強調(diào)也可以直接插在文字中間：

un*frigging*believable

但是如果你的 * 和 _ 兩邊都有空白的話，它們就只會被當(dāng)成普通的符號悯仙。

如果要在文字前後直接插入普通的星號或底線龄毡，你可以用反斜線：

\*this text is surrounded by literal asterisks\*

<h3 id="code">程式碼</h3>

如果要標(biāo)記一小段行內(nèi)程式碼，你可以用反引號把它包起來（`）锡垄，例如：

Use the `printf()` function.

會產(chǎn)生：

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

如果要在程式碼區(qū)段內(nèi)插入反引號沦零，你可以用多個反引號來開啟和結(jié)束程式碼區(qū)段：

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

這段語法會產(chǎn)生：

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

程式碼區(qū)段的起始和結(jié)束端都可以放入一個空白，起始端後面一個货岭，結(jié)束端前面一個路操，這樣你就可以在區(qū)段的一開始就插入反引號：

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

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

會產(chǎn)生：

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

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

在程式碼區(qū)段內(nèi)，& 和方括號都會被轉(zhuǎn)成 HTML 實體千贯，這樣會比較容易插入 HTML 原始碼屯仗，Markdown 會把下面這段：

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

轉(zhuǎn)為：

<p>Please don't use any <code><blink></code> tags.</p>

你也可以這樣寫：

`—` is the decimal-encoded equivalent of `—`.

以產(chǎn)生：

<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>

<h3 id="img">圖片</h3>

很明顯地，要在純文字應(yīng)用中設(shè)計一個 「自然」的語法來插入圖片是有一定難度的搔谴。

Markdown 使用一種和連結(jié)很相似的語法來標(biāo)記圖片魁袜，同樣也允許兩種樣式： 行內(nèi)和參考。

行內(nèi)圖片的語法看起來像是：

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

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

詳細(xì)敘述如下：

• 一個驚嘆號 !
• 接著一對方括號敦第，裡面放上圖片的替代文字
• 接著一對普通括號峰弹，裡面放上圖片的網(wǎng)址，最後還可以用引號包住並加上
  選擇性的 'title' 文字芜果。

參考式的圖片語法則長得像這樣：

![Alt text][id]

「id」是圖片參考的名稱鞠呈，圖片參考的定義方式則和連結(jié)參考一樣：

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

到目前為止， Markdown 還沒有辦法指定圖片的寬高右钾，如果你需要的話蚁吝，你可以使用普通的 <img> 標(biāo)籤。

<h2 id="misc">其它</h2>

<h3 id="autolink">自動連結(jié)</h3>

Markdown 支援比較簡短的自動連結(jié)形式來處理網(wǎng)址和電子郵件信箱霹粥，只要是用方括號包起來灭将， Markdown 就會自動把它轉(zhuǎn)成連結(jié)，連結(jié)的文字就和連結(jié)位置一樣后控，例如：

<http://example.com/>

Markdown 會轉(zhuǎn)為：

<a >http://example.com/</a>

自動的郵件連結(jié)也很類似，只是 Markdown 會先做一個編碼轉(zhuǎn)換的過程空镜，把文字字元轉(zhuǎn)成 16 進位碼的 HTML 實體浩淘，這樣的格式可以混淆一些不好的信箱地址收集機器人捌朴，例如：

<address@example.com>

Markdown 會轉(zhuǎn)成：

<a href="mailto:addre
ss@example.co
m">address@exa
mple.com</a>

在瀏覽器裡面，這段字串會變成一個可以點擊的「address@example.com」連結(jié)张抄。

（這種作法雖然可以混淆不少的機器人砂蔽，但並無法全部擋下來，不過這樣也比什麼都不做好些署惯。無論如何左驾，公開你的信箱終究會引來廣告信件的。）

<h3 id="backslash">跳脫字元</h3>

Markdown 可以利用反斜線來插入一些在語法中有其它意義的符號极谊，例如：如果你想要用星號加在文字旁邊的方式來做出強調(diào)效果（但不用 <em> 標(biāo)籤）诡右，你可以在星號的前面加上反斜線：

\*literal asterisks\*

Markdown 支援在下面這些符號前面加上反斜線來幫助插入普通的符號：

\   反斜線
`   反引號
*   星號
_   底線
{}  大括號
[]  方括號
()  括號
#   井字號
+   加號
-   減號
.   英文句點
!   驚嘆號

<h2 id="acknowledgement">感謝</h2>

感謝 leafy7382 協(xié)助翻譯，hlb轻猖、Randylien 幫忙潤稿帆吻，ethantw 的漢字標(biāo)準(zhǔn)格式?CSS Reset， WM 回報文字錯誤咙边。