Markdown

來自維基學院

語法[編輯 | 編輯原始碼]

圖片[編輯 | 編輯原始碼]

![中文維基學院LOGO](https://upload.wikimedia.org/wikipedia/commons/5/58/Wikiversity-logo-zh.svg)

換行[編輯 | 編輯原始碼]

在文本中輸入的換行會從最終生成的結果中刪除,瀏覽器會根據可用空間自動換行。如果想強迫換行,可以在行尾插入至少兩個空格。

強調[編輯 | 編輯原始碼]

*強調* 或者 _強調_(示例:斜體)

 
**加重強調** 或者 __加重強調__

又或者以制表符或至少四個空格縮進的行,例如:

    第一行代碼
    第二行代碼
    第三行代碼

後面一種用法會讓Markdown保留所有的空白字符——而與之相反,一般情況下,Markdown會刪除所有換行和空格,打亂原有的縮進和排版。

標題[編輯 | 編輯原始碼]

可以在標題內容前輸入特定數量的井號#來實現對應級別的HTML樣式的標題(HTML提供六級標題)。例如:

# 一級標題

#### 四級標題

一級和二級標題還有一種寫法:

一級標題
===================

二級標題
--------------------

斷行[編輯 | 編輯原始碼]

如果你真的想在Markdown中插入換行標籤<br/>,你可以在行尾輸入兩個或以上的空格,然後回車。 這樣插入換行十分麻煩,而且「每個換行都轉換為<br/>」在 Markdown中並不合適,所以只在你確定你需要時手動添加。

引用[編輯 | 編輯原始碼]

引用只需要在被引用的內容段落開頭加上右尖括號>即可。你可以選擇只在開頭加一個。也可以在每行前面都加一個,效果是一樣的。

> 這一整段的內容都會作為一個HTML的引用元素。
引用元素是會自動優化排版的(reflowable,可回流)。
你可以任意地將引用的內容包含進來,然後所有這些都會
被解析成為單獨一個引用元素。

上述內容會轉換成以下HTML內容:

<blockquote><p>这一整段的内容都会作为一个HTML的引用元素。引用元素是会自动优化排版的(reflowable,可回流)。
你可以任意地将引用的内容包含进来,然后所有这些都会被解析成为单独一个引用元素。</p></blockquote>

引用可以嵌套。如果要在一個引用里插入一個引用,可以用兩個>開頭。依此類推,根據嵌套層次加相應數量的符號。

> 這是一個引用。這是第一行
這是第二行。
>> 這是一個嵌套的引用。這是第一行。
這是第二行
> 
> 外層引用的第三行。前面需要一個視覺上的空行表示內層嵌套的結束,空行前面的>可以有可以沒有。

鏈接[編輯 | 編輯原始碼]

鏈接可以在行內插入:

[鏈接文字](鏈接地址)
例子: [Markdown](http://zh.wikipedia.com/wiki/Markdown)

另一種選擇是,鏈接地址可以放在段落後面的腳註,前面放上鏈接引用標籤區分。舉例說,先在內容行內插入以下內容:

[鏈接文字][鏈接引用標籤]

然後在段落的後面(或者文檔的結尾)放上以下內容,就可以生成一個鏈接:

[鏈接引用標籤]: 鏈接地址 "鏈接標題"

水平分割線[編輯 | 編輯原始碼]

要生成水平分割線,可以在單獨一行里輸入3個或以上的短橫線、星號或者下劃線實現。短橫線和星號之間可以輸入任意空格。以下每一行都產生一條水平分割線。

* * *
***
*****
- - -
---------------------------------------

Markdown與HTML轉換之例子[編輯 | 編輯原始碼]

Text using Markdown syntax Corresponding HTML produced by a Markdown processor Text viewed in a browser
# 標題

## 二級標題

Paragraphs are separated
by a blank line.

Two spaces at the end of a line  
produces a line break.

Text attributes _italic_, 
**bold**, `monospace`.

Horizontal rule:

---

Bullet list:

  * apples
  * oranges
  * pears

Numbered list:

  1. wash
  2. rinse
  3. repeat

A [link](http://example.com).

![Image](Image_icon.png)

> Markdown uses email-style > characters for blockquoting.

Inline <abbr title="Hypertext Markup Language">HTML</abbr> is supported.
<h1>標題</h1>

<h2>二級標題</h2>

<p>Paragraphs are separated
by a blank line.</p>

<p>Two spaces at the end of a line<br />
produces a line break.</p>

<p>Text attributes <em>italic</em>, 
<strong>bold</strong>, <code>monospace</code>.</p>

<p>Horizontal rule:</p>

<hr />

<p>Bullet list:</p>

<ul>
<li>apples</li>
<li>oranges</li>
<li>pears</li>
</ul>

<p>Numbered list:</p>

<ol>
<li>wash</li>
<li>rinse</li>
<li>repeat</li>
</ol>

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

<p><img alt="Image" src="Image_icon.png" /></p>

<blockquote>
<p>Markdown uses email-style &gt; characters for blockquoting.</p>
</blockquote>

<p>Inline <abbr title="Hypertext Markup Language">HTML</abbr> is supported.</p>

Paragraphs are separated by a blank line.

Two spaces at the end of a line
produces a line break.

Text attributes italic, bold, monospace.

Horizontal rule:


Bullet list:

  • apples
  • oranges
  • pears

Numbered list:

  1. wash
  2. rinse
  3. repeat

A link.

Image

Markdown uses email-style > characters for blockquoting.

Inline HTML is supported.

參考[編輯 | 編輯原始碼]

維基百科中的相關條目: