Markdown 的進階用法

這一部分是擴展上一篇「以Markdown增強文字格式」的基本訊息,好讓那些有特殊需要的人能充分運用 Markdown。 如果您不認同或您不需要使用列在下面的格式,那您可以跳過這一部分,等到您有需要時再來看。

文字跳行

在某些文字中,比如詩詞或箴言,它通常需要插入跳行符號,試著按 enter 鍵 通常無法得到所要的效果,因為預設是各行會自動連接在一起形成一個段落。

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

上述的輸入,是使用enter 鍵來插入斷行符號,結果在顯示時,這些斷行符號就被忽視了:

The best laid schemes o' Mice an' Men, Gang aft agley, An' lea'e us nought but grief an' pain, For promis'd joy!

但是每一行末尾加上兩個空白您也可以強迫文字跳行,就像下面:

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

插入水平線

您可以連續打上三個或以上的星號(*),破折號(-) 或底線(_) ,來建立一條水平線。

這樣就可以了:

***

但是您可以加上空格,或更多的字元,使它在文字編輯視窗中看得更明顯,例如:

* * * * *

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

_ _ _ _ _

以上這些方法都會導致相同的結果,像下面這條橫線:


連結的圖片

The Enhancing Text With Markdown document gives instructions for creating web links and inserting images. It may not be obvious that these can be combined to create images that are also clickable links.

[the google search engine][google]

![the google logo][logo]

Above are a standard web link and image. By placing the image where the link text would be found you end up with this:

[![the google logo][logo]][google]

This line above, in combination with the following link definitions elsewhere in the document:

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "點選可訪問 Google.com"

combine to produce the following clickable image link (若您滑鼠指向它會出現工具提示):

the google logo

An example of where this technique might be handy is in linking small 'thumbnail' images to downloads of the larger photos.

鑲入HTML標籤

If you are already proficient in HTML then there may be occasions when Markdown does not allow you as much control as you are used to. Luckily Markdown is designed for this eventuality and allows you to embed HTML directly within Markdown formatted text.

* <small>小號文字</small>
* <big>大號文字</big>

  • 小號文字
  • 大號文字

Note that the HTML markup co-exists with the Markdown code for bullet lists. This frees you from the mundane task of writing complex HTML for basic formatting features such as paragraphs and lists while still allowing you to access the full power of HTML in specific situations.

顯示HTML或事先格式化的文字

如果,不像本節上半部,您希望您所輸入的 HTML 要如你所輸入的樣子顯示出來,而不是當作 HTML 來處理。 ,那您可以在每一行之前按四個空白鍵

<p>A paragraph in <b>HTML</b> displayed as code</p>

這方法在顯示電腦程式碼時也同樣有效:

print "Command-line arguments: (@ARGV)\n";

這個方式經常用來在螢幕上列出電腦程式,以及其他包含有 Markdown 所用的格式化字元的文字。這時 Markdown的格式化動作 會被關閉:

通常這個字將是**bold**。

要在正常的文字裡包含這類字元,請看下面。

使用特殊字元

若您希望使用任何會引起 Markdown 格式化的特殊字元,但又不希望它被處理,您只要在它們的前面加上 後斜線字元(\)即可。它就是所謂的'逃避'字元。這一後斜線不會顯示出來,但緊接在後的字元會顯示出來, 就和輸入時完全一樣。例如:

\*asterisks, not emphasis\*

會變成

*asterisks, not emphasis*

而不是用

*emphasis, not asterisks*

它會變成

emphasis, not asterisks

進一步的參考資料

Markdown 系統不是 Moodle 所獨有的,不斷有更多的網頁出版工具在使用它, 您可以在 http://daringfireball.net/projects/markdown/ 找到更多資料。

輔助說明檔案的索引
以English語言顯示輔助說明