概述
1、兼容HTML
HTML是一種發布的格式,Markdown是一種發布的格式。Markdown 語法在 HTML 區段標簽間是有效的。
Markdown 的生成器有足夠智能,不會在 HTML 區塊標簽外加上不必要的
標簽。
例:
這是一個普通段落。
<table>
<tr>
<td>1</td>
</tr>
</table>
這是另一個普通段落。
1.1表格
(作者:熱心市民123
鏈接:http://www.lxweimin.com/p/59aaa82ae723
來源:簡書
簡書著作權歸作者所有,任何形式的轉載都請聯系作者獲得授權并注明出處。)
表格前一定要空一行
在每個單元格文字的兩端加上一個豎線“|”。
第二行控制單元格文本的位置,第二行控制文本的位置,規則如下:默認是靠左,用英文冒號“:”來調整,兩邊都有冒號,而且冒號中間至少有一個減號“-”的時候表示居中(當然也可以通過增加“-”號的數目來使它們對齊,更好看一點,但效果是一樣的);冒號在右邊而且冒號之前至少有一個-的時候表示靠右,其它情況則是靠左。注意,冒號“:”一定要為英文的,不可為中文的冒號。如:
第一季度 | 第二季度 | 第三季度 | 第四季度 |
---|---|---|---|
20% | 30% | 25% | 40% |
2、特殊字符自動轉換
在 HTML 文件中,有兩個字符需要特殊處理: < 和 & 。 < 符號用于起始標簽,& 符號則用于標記 HTML 實體,如果你只是想要顯示這些字符的原型,你必須要使用實體的形式,像是 &lt和 &。
注意:code 范圍內,不論是行內還是區塊, < 和 & 兩個符號都一定會被轉換成 HTML 實體,這項特性讓你可以很容易地用 Markdown 寫 HTML code ;而HTML 語法中,要把所有的 < 和 & 都轉換為 HTML 實體,才能在 HTML 文件里面寫出 HTML code。
二、區塊元素
1.段落和段行
2.標題
Markdown 支持兩種標題的語法,類 Setext 和類 atx 形式。
類 Setext :是用底線的形式,利用 = (最高階標題)和 - (第二階標題)
例:This is an H1
=============
This is an H2
類 atx :在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階
例:
這是 H1 #
這是 H2 ##
這是 H3 ######
3.區塊引用
在每行的最前面加上 > ;在整個段落的第一行最前面加上 > ;區塊引用可以嵌套(例如:引用內的引用),只要根據層次加上不同數量的 > ;引用的區塊內也可以使用其他的 Markdown 語法,包括標題、列表、代碼區塊等;
例:
這是一個標題。
- 這是第一行列表項。
- 這是第二行列表項。
給出一些例子代碼:
return shell_exec("echo
markdown_script");
4.列表
無序列表:使用星號、加號或是減號作為列表標記
有序列表:使用數字接著一個英文句點(數字的正確性不用在意)
例:
好
哈
注意:列表項目可以包含多個段落,每個項目下的段落都必須縮進 4 個空格或是 1 個制表符:;列表要放代碼區塊的話,該區塊就需要縮進兩次,也就是 8 個空格或是 2 個制表符
5.代碼區塊
縮進 4 個空格或是 1 個制表符;一個代碼區塊會一直持續到沒有縮進的那一行(或是文件結尾)。
6.分割線
在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。也可以在星號或是減號中間插入空格:
三、區段元素
1.鏈接
鏈接文字都是用 [方括號] 來標記。
鏈接內容定義的形式為:
方括號(前面可以選擇性地加上至多三個空格來縮進),里面輸入鏈接文字
接著一個冒號
接著一個以上的空格或制表符
接著鏈接的網址
選擇性地接著 title 內容,可以用單引號、雙引號或是括弧包著
2.強調
Markdown 使用星號(*)和底線(_)作為標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用 標簽包圍,用兩個 * 或 _ 包起來的話,則會被轉成<strong>
例:
single asterisks
single underscores
double asterisks
double underscores
會轉成:
single asterisks
single underscores
double asterisks
double underscores
注意:*和_兩邊不能都有空白,否則會被當作普通符號
3.代碼
標記一小段行內代碼,可以用反引號把它包起來(`)
4.圖片
行內式:
[圖片上傳失敗...(image-94cbbd-1535548389219)]
[圖片上傳失敗...(image-4ccdee-1535548389219)]
詳細敘述如下:
一個驚嘆號 !
接著一個方括號,里面放上圖片的替代文字
接著一個普通括號,里面放上圖片的網址,最后還可以用引號包住并加上 選擇性的 'title' 文字。
參考式:
「id」是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣:
四、補充
1.反斜杠
Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:
\ 反斜線
` 反引號
- 星號
_ 底線
{} 花括號
[] 方括號
() 括弧
井字號
- 加號
- 減號
. 英文句點
! 驚嘆號
2.自動鏈接
支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱,只要是用方括號包起來, Markdown 就會自動把它轉成鏈接。
五、Markdown 免費編輯器
1.Windows 平臺
Markdownpad
Markpad
2.Linux 平臺
Retext
Mac 平臺
Mou
3.在線編輯器
Markable.in
Dillinger.io
4.瀏覽器插件
MaDe(Chrome)