MarkDown:基礎知識

• 段落、標題、區塊代碼
• 斜體和粗體
• 列表
• 超鏈接
• 圖片
• 代碼

獲取Markdown格式語法的要點

這頁提供了 markdown 簡單的概述給想使用的人，語法說明 頁提供了完整詳細的文件，說明每項功能，但是Markdown其實很簡單就可以上手，這頁文件提供了一些範例，並且每個範例都有提供輸出的HTML結果。

其實直接試試看也是一個很不錯的方法，Dingus是一個網頁應用程序，讓你可以把你的Markdown文件轉成XHTML。

Note: 這份文件本身也是用markdown寫到，你也可以看看它的原始文件

段落、標題、區塊代碼

一個Enter(回車)代表空格，
兩個Enter

一個段落實由一個以上的連接的行句組成，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，就被視為空行，例如有一行只有空白和tab，那該行也會被視為空行），一般的段落不需要用空白或斷行縮排。

markdown支持兩種標題語法，[Setext][1]和[atx][2]形式，Setext形式使用底線的形式，利用=(最高階標題)和-(第二階標題)，Atx形式在行首插入1到6個#（井號），對應到標題1到6階。

區塊引用則使用email形式的‘>‘(角括號、大於號)表示。

Markdown語句:

A First Level Header(一級標題)
====================

A Second Level Header(二級標題)
---------------------

我思故
我在
--笛卡爾

### Header 3(三級標題)

> 這是一個引用
> 
> 這是引用的第二段
>
> ## 這是引用中的二級標題
 

輸出的HTML語句：

<h1>A First Level Header(一級標題)</h1>

<h2>A Second Level Header(二級標題)</h2>

<p>我思故
我在
--笛卡爾</p>
    
<h3>Header 3(三級標題)</h3>

<blockquote>
    <p>這是一個引用</p>
    
    <p>這是引用的第二段</p>
    
    <h2>這是引用中的二級標題</h2>
</blockquote>
 

斜體和粗體

Markdown使用*(星號)和_(底線)來標記需要強調的文本。

Markdown:

部分文字為*斜體*
同樣有部分文字為_斜體_

使用兩個星號代表**強調**
或者，如果您願意，__使用兩個下劃線代替__

輸出的HTML語句：

<p>部分文字為<em>斜體</em>
同樣有部分文字為<em>斜體</em></p>

<p>使用兩個星號代表<strong>強調</strong>
或者，如果您願意，<strong>使用兩個下劃線代替</strong></p>

列表

無序列表使用*(星號)、+(加號)和-(減號)來作為列表的項目標記，這些符號都是可以使用的。

使用*(星號)：

*   糖果
*   口香糖
*   酒

使用+(加號)：

+   糖果
+   口香糖
+   酒

使用-(減號)：

-   糖果
-   口香糖
-   酒

都會輸出：

<ul>
<li>糖果</li>
<li>口香糖</li>
<li>酒</li>
</ul>

有序列表則使用一般的數字和英文句號作為項目標記：

1. 紅色
2. 綠色
3. 藍色

輸出：

<ol>
<li>紅色</li>
<li>綠色</li>
<li>藍色</li>
</ol>

如果你在項目之間插入空行，那麽項目的內容會用<p>標簽包起來，你也可以在一個項目內放上多個段落，只要在它前面縮進4個空格或1個tab。

*   列表項。

    有多個段落。

*   列表中的另一項。

輸出：

<ul>
<li>
    <p>列表項。</p>
    <p>有多個段落。</p>
</li>
<li>
    <p>列表中的另一項。</p>
</li>
</ul>

超鏈接

Markdown支持兩種形式的插連接語法： 行內 和 參考 兩種形式，兩種都是使用[]方括號來把文字轉成超鏈接。

行內形式是直接在[]方括號和面附上鏈接地址：

這是一個[示例鏈接](http://example.com/)。

輸出：

<p>這是一個<a href="http://example.com/">示例鏈接</a>。</p>

你也可以選擇性的加上 title 屬性：

這是一個[示例鏈接](http://example.com/ "標題")。

輸出：

<p>這是一個<a href="http://example.com/" title="標題">示例鏈接</a>。</p>

參考形式的超鏈接讓你可以為超鏈接定義一個名稱，之後你可以在文件的其他地方定義該超鏈接的內容：

訪問[百度][1]，[騰訊][2]，[阿裏巴巴][3]。

[1]: https://www.baidu.com/ "百度"
[2]: https://www.tencent.com/zh-cn/index.html "騰訊"
[3]: http://www.alibaba.com/ "阿裏巴巴"

輸出：

<p>訪問
<a href="https://www.baidu.com/" title="百度">百度</a>，
<a href="https://www.tencent.com/zh-cn/index.html" title="騰訊">騰訊</a>，
<a href="http://www.alibaba.com/" title="阿裏巴巴">阿裏巴巴</a>。
</p>

title 屬性是選擇性的，連接名稱可以用字母、數字和空格，但是不分大小寫：

訪問[騰訊首頁][QQ]

[qq]: http://www.qq.com/ "騰訊網"

輸出：

<p>訪問<a href="http://www.qq.com/" title="騰訊網">騰訊首頁</a></p>

圖片

圖片的語法和超鏈接很像。

行內行式（title 是選擇性的）：

![MD](https://i.imgur.com/hRqgd0o.jpg "Markdown")

參考形式：

![MD][id]

[id]: https://i.imgur.com/hRqgd0o.jpg "Markdown"

上面兩種方法都會輸出：

<p>
<img src="https://i.imgur.com/hRqgd0o.jpg" alt="MD" title="Markdown" />
</p>

代碼

在一般的段落文字中，你可以使用反引號` 來標記程序碼區段，區段內的&、<和>都會被自動裝換成HTML實體&、&lt、>，這項特性讓你可以很容易的在程序區段內插入HTML碼：

我強烈建議不要使用任何`<blink>`標簽&。

輸出：

<p>我強烈建議不要使用任何<code>&lt;blink&gt;</code>標簽&amp;。</p>

如果要建立一個已經格式化好的程序碼區塊，只要每行都縮進4個空格或是一個tab就可以了，而&、<和>也一樣會自動裝成HTML實體。

Markdown:

如果您希望您的頁面在XHTML 1.0 Strict下驗證，
你必須在你的blockquotes中放置段落標記：

    <blockquote>
        <p>例子</p>
    <blockquote>

輸出：

<p>
如果您希望您的頁面在XHTML 1.0 Strict下驗證，
你必須在你的blockquotes中放置段落標記：
</p>

<pre>
<code>&lt;blockquote&gt;
    &lt;p&gt;例子&lt;/p&gt;
&lt;blockquote&gt;
</code>
</pre>

MarkDown:基礎知識