語法

編輯

圖片

編輯

![中文維基學院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.

 

Markdown uses email-style > characters for blockquoting.

Inline HTML is supported.

參考

編輯
 
維基百科中的相關條目: