Day 6 - Markdown 紀錄

Markdown 紀錄

Markdown 的重點在於,它能讓文件更容易閱讀、編寫。HTML 是一種發佈的格式,Markdown 是一種編寫的格式
請注意,Markdown 語法在 HTML 區塊標籤中將不會被進行處理。例如,你無法在 HTML 區塊內使用 Markdown 形式的強調
HTML 的區段標籤如 <span>、<cite>、<del> 則不受限制
特殊字元自動轉換 跟Html有差異

區塊元素

段落和換行

要插入 <br /> 標籤的話,在行尾加上兩個以上的空白,然後按 enter。

標題

# This is an H1

## This is an H2

###### This is an H6

Blockquotes

Markdown 也允許你只在整個段落的第一行最前面加上 > :
區塊引言可以有階層(例如:引言內的引言),只要根據層數加上不同數量的 > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
This is the first level of quoting.
This is nested blockquote.
Back to the first level.

清單

無序清單使用星號、加號或是減號作為清單標記:
清單項目標記通常是放在最左邊,但是其實也可以縮排,最多三個空白,項目標記後面則一定要接著至少一個空白或 tab。
  • Red
  • Green
  • Blue

程式區塊

Markdown 會用 <pre><code> 標籤來把程式碼區塊包起來。
只要簡單地縮排 4 個空白或是 1 個 tab 就可以
This is a normal paragraph:
tell application "Foo"
    beep
end tell

分隔線

你可以在一行中用三個或以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西
***

*****
ex:

區段元素

連結

Markdown 支援兩種形式的連結語法:行內參考 兩種形式。
連結的文字都是用 [方括號] 來標記,想要加上連結的 title 文字,只要在網址後面,用雙引號把 title 文字包起來即可。
要連結到同樣主機的資源,你可以使用相對路徑

行內形式用法:
This is [an example](http://example.com/ "Title") inline link.

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

參考形式用法:
使用另外一個方括號接在連結文字的括號後面,而在第二個方括號裡面要填入用以辨識連結的標籤:
This is [an example][id] reference-style link.
This is an example reference-style link.
接著,在文件的任意處,你可以把這個標籤的連結內容定義出來:
[id]: http://example.com/  "Optional Title Here"
連結定義的形式為:
  • 方括號,裡面輸入連結的辨識用標籤
  • 接著一個冒號
  • 接著一個以上的空白或 tab
  • 接著連結的網址
  • 選擇性地接著 title 內容,可以用單引號、雙引號或是括弧包著
連結辨識標籤可以有字母、數字、空白和標點符號,但是並不區分大小寫
預設的連結標籤功能讓你可以省略指定連結標籤,改成用連結名稱的方式寫
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"
I get 10 times more traffic from Google than from Yahoo or MSN.

強調

使用星號(*)和底線(_)作為標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用 <em> 標籤包圍,用兩個 * 或 _ 包起來的話,則會被轉成 <strong>
*single asterisks*

_single underscores_

**double asterisks**

__double underscores__
single asterisks
single underscores
double asterisks
double underscores

程式碼

如果要標記一小段行內程式碼,你可以用反引號把它包起來(`
Use the `printf()` function.

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

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

圖片

Markdown 使用一種和連結很相似的語法來標記圖片,同樣也允許兩種樣式: 行內參考
行內語法:
![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")
詳細敘述如下:
  • 一個驚嘆號 !
  • 接著一個方括號,裡面放上圖片的替代文字
  • 接著一個普通括號,裡面放上圖片的網址,最後還可以用引號包住並加上 選擇性的 'title' 文字
參考語法:
![Alt text][id]
「id」是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣:
[id]: url/to/image  "Optional title attribute"
到目前為止, Markdown 還沒有辦法指定圖片的寬高,如果你需要的話,你可以使用普通的 <img> 標籤。

其它

自動連結

Markdown 支援比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用方括號包起來, Markdown 就會自動把它轉成連結,連結的文字就和連結位置一樣
<http://example.com/>
<address@example.com>
http://example.com/
address@example.com

跳脫字元

利用反斜線來插入一些在語法中有其它意義的符號
\*literal asterisks\*
*literal asterisks*
支援在下面這些符號前面加上反斜線來幫助插入普通的符號:
\   反斜線
`   反引號
*   星號
_   底線
{}  大括號
[]  方括號
()  括號
#   井字號
+   加號
-   減號
.   英文句點
!   驚嘆號

完整內容網址

http://zh.mweb.im/markdown-syntax-guide-full-version-zh.html
MWeb使用說明:
http://zh.mweb.im/help.html
Markdown資源分享:
http://yuhua-chen.logdown.com/tags/StackEdit
StackEdit介紹:
http://blog.unicsolution.com/2013/08/logdown.html

留言