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 asteriskssingle 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.htmlMWeb使用說明:
http://zh.mweb.im/help.html
Markdown資源分享:
http://yuhua-chen.logdown.com/tags/StackEdit
StackEdit介紹:
http://blog.unicsolution.com/2013/08/logdown.html
留言
張貼留言