Markdown 語法

1 這語法夠直接了,但少用還是會忘, 所以我寫個筆記

2 Markdown的格式語法只涵蓋純文字可以涵蓋的範圍 ;
文字以外的 仍用html,只要直接加標籤就可以了.

3 只有“區塊“元素──比如


、、等標籤,必需在前後加上空行,以利與內容區隔
而且這些(元素)的開始與結尾標籤,不可以用tab或是空白來縮排This is an example
(空行)(空行)4 Markdown語法在HTML區塊標籤中將不會被進行處理
所以不要用markdown 在這些區塊標籤裡.5 但HTML的"區段"標籤如則不受限制,可以在Markdown的段落、清單或是標題裡任意使用6 也可以不用Markdown格式,而採用HTML標籤來格式化例:
如果比較喜歡HTML的 標籤,可以直接使用這些標籤,而不用Markdown提供的連結或是影像標示語法7.在html “區段"標籤的範圍內,Markdown的語法是有效的8. html 文件,有兩個符號要特別留意1) <
如果使用<符號作為HTML標籤使用,那Markdown也不會對它做任何轉換
但 4 < 5 在markdown 語法會是 4 <52) & — 要寫成& (我都念and amp 分號),
markdown 語言可以直接用3) 寫著作權可以直接寫. ©9 段落和換行1) Markdown允許段落內的強迫斷行用. html 斷行是用2) 空行的定義是顯示上看起來像是空行,便會被視為空行10 標題兩種標題的語法,Setext和atx形式。1) Setext形式: 用底線的形式.雙線與單線
=================
________________________2) Atx形式 : 在行首插入1到6個 # ,各對應到標題1到6階#
##
###
####
#####
######可選擇性地「關閉」atx樣式的標題,這純粹只是美觀用的,
若是覺得這樣看起來比較舒適,你就可以在行尾加上#,而行尾的#數量也不用和開頭一樣(行首的井字數量決定標題的階數)11 區塊引言: 只在整個段落的第一行最前面加上>1) >
2) 區塊引言可以有階層(例如:引言內的引言),只要根據層數加上不同數量的>
3) 引言的區塊內也可以使用其他的Markdown語法12 清單1)無序清單使用星號
*
**
***2) 有序清單則使用數字接著一個英文句點1.
2.
3.要讓清單看起來更漂亮,你可以把內容用固定的縮排整理好3) 如果清單項目間用空行分開, Markdown會把項目的內容在輸出時用標籤包起來4) 清單項目可以包含多個段落,每個項目下的段落都必須"縮排4個空白"或是"一個 tab"5) 如果要在清單項目內放進引言,那>就需要縮排例
1. This is my book> time is money6) 清單 要放程式碼區塊的話,該區塊就需要縮排兩次,也就是8個空白或是兩個tab例  13 程式碼區塊1)要在Markdown中建立程式碼區塊很簡單,只要簡單地縮排4個空白或是1個tab就可以例
This is Joe’s coding
This is joe’s coding2) 一個程式碼區塊會一直持續到沒有縮排的那一行
3)在程式碼區塊裡面,&、<和>會自動轉成HTML實體
4)程式碼區塊中,一般的Markdown語法不會被轉換14 分隔線可以在一行中用三個或以上的星號、減號、底線來建立一個分隔線例
***

_____
15 連結
[an example](http://example.com/ “Title")例: 下面這三種連結的定義都是相同:
[foo]: http://example.com/ “Optional Title Here"
[foo]: http://example.com/ ‘Optional Title Here’
[foo]: http://example.com/ (Optional Title Here)16 強調
Markdown使用星號(*)和底線(_)作為標記強調字詞的符號17程式碼如果要標記一小段行內程式碼,你可以用反引號把它包起來(`)例:
`test()`18 自動連結
只要是用方括號包起來,Markdown就會自動把它轉成連結,連結的文字就和連結位置一樣例
<http://www.google.com>19 自動的郵件連結

<joe@gmail.com>20 在星號的前面加上反斜線, 用星號加在文字旁邊的方式來做出強調效果
例:
\*joe\*

這是我的練習1 標題練習
#Joe#
##Joe##
###Joe###
####Joe####
#####Joe#####
######Joe#####2 強調
*Joe* (斜體, italic)
**Joe **(Bold)
***Joe ***3 Listing items
用下橫線.
_Joe *Joe
-Peter *Peter
_Tom *Tom4 順序
1.Joe
2.Peter
3.Tom5 連結
[arttek](http://art-tek.weebly.com/ “Welcome to arttek"


廣告

Markdown editor: Markable

Markdown 的Editor 有很多, 我覺得這個好好用. Markable (http://markable.in/)

實在夠簡單, 也可存到drop box, 或evernote, 也可傳到Tumblr, 也可以download 輸出成html檔, 瀏覽器上就可以看. 我都測過了. 編輯時,畫面右側就可以直接看.

markable

%d 位部落客按了讚: