標(biāo)準(zhǔn)md語(yǔ)法教程- Markdown從入門到精通 （送晴編寫）

tags: 送晴 Markdown 語(yǔ)法教程

寫在前面：

1. 目的：這個(gè)文檔自身就是使用 Markdown 編寫的。Markdown 允許你通過編寫易讀、易寫的富文本格式，然后很方便就可以轉(zhuǎn)換成有效的 HTML。
2. 本教程以一般方案的書寫習(xí)慣為便。致力于打造最全面的md語(yǔ)法教程，若發(fā)現(xiàn)錯(cuò)漏歡迎加QQ群聯(lián)系本人
3. 應(yīng)用的軟件：以 XXX 軟件的語(yǔ)法為標(biāo)準(zhǔn)，其他軟件平臺(tái)部分語(yǔ)法規(guī)范不一樣的話，部分項(xiàng)將不能顯示，請(qǐng)知悉。
4. 編寫整理本教程耗費(fèi)作者很多心血，轉(zhuǎn)載請(qǐng)保留出處，歡迎加QQ群123456交流，并有各pc，安卓，mac各平臺(tái)md相關(guān)軟件和實(shí)用資料的下載。后期打算制作視頻教程哦^-
5. 感謝原創(chuàng)作者和軟件開發(fā)者的無私共享。
6. 本軟件全程使用md語(yǔ)法書寫，全部中文表述，充分考慮了國(guó)內(nèi)的小白用戶。

MD入門語(yǔ)法教程

標(biāo)題

• 主標(biāo)題：

【語(yǔ)法】主標(biāo)題文字 空行 ==（兩個(gè)及以上）
【示例】
主標(biāo)題文字（最高階標(biāo)題）
==
【說明】相當(dāng)于H1大綱標(biāo)題效果，一般在首行應(yīng)用和表示

• 副標(biāo)題：

【語(yǔ)法】副標(biāo)題文字 （空行） ---減號(hào)兩個(gè)及以上
【示例】
副標(biāo)題文字（第二階標(biāo)題）
--
【說明】相當(dāng)于H2大綱標(biāo)題效果

• H1~H6大綱標(biāo)題

【語(yǔ)法】#（空格）文字 或 #（空格）文字 （空格）#） （1-6等級(jí)分別在文字前加對(duì)應(yīng)數(shù)量#，后面的#為可選，不加效果也一樣。
【示例】

大綱標(biāo)題文字 H1（等同 主標(biāo)題）

大綱標(biāo)題文字 H2（等同 副標(biāo)題）

大綱標(biāo)題文字 H3

大綱標(biāo)題文字 H4

大綱標(biāo)題文字 H5

大綱標(biāo)題文字 H6

####### 大綱標(biāo)題文字 H7（最多6階）

【說明】最多6個(gè)等級(jí)的大綱標(biāo)題，后面加上同等數(shù)量“（空格）#”效果也一樣

標(biāo)簽

【語(yǔ)法】TAGS：內(nèi)容 或直接標(biāo)簽：內(nèi)容 ，即 在編輯區(qū)任意行的列首位置輸入tags/標(biāo)簽：關(guān)鍵詞1 關(guān)鍵詞2 ， 多個(gè)用空格隔開。
【示例】
標(biāo)簽： 教程 Markdown
或者
Tags： 教程 2016年 重要的

目錄（大綱）導(dǎo)航

【語(yǔ)法】 在段落中填寫 [TOC] （toc小寫也可以）以顯示各標(biāo)題為結(jié)構(gòu)的目錄（大綱）導(dǎo)航。
【示例】

[TOC]

強(qiáng)調(diào)或突出

• 斜體

【語(yǔ)法】_斜體_ 或 *斜體* 在文字兩邊加 單下底線 或 單星號(hào)
【示例】 斜體 或 斜體

• 粗體

【語(yǔ)法】__粗體__ 或 **粗體** 在文字兩邊加 雙下底線 或 雙星號(hào)
【示例】 粗體 或 粗體

• 刪除線

【語(yǔ)法】~~刪除線~~ 在文字兩邊加 雙波浪號(hào)
【示例】這是帶有 刪除線 的文字
【說明】快速記憶：?jiǎn)涡彪p粗兩波刪

• 下劃線

【語(yǔ)法 】 在空白行下方添加三條“-”橫線。（前面講過在文字下方添加“-”，實(shí)現(xiàn)的2級(jí)標(biāo)題）
【示例】
這是---下劃線---
你看到了嗎？

段落與分割

• 普通段落

【語(yǔ)法】用空行分隔，連著多個(gè)空行也是一個(gè)效果，只能空一行的間距。
【示例】

這是首行文字

這是尾行文字，實(shí)際中間我空了7行，但還是只顯示空了一行的效果。

【說明】有的語(yǔ)法要用到空行才有效果（如主標(biāo)題，列表），不空行的話默認(rèn)又是會(huì)跟隨上面語(yǔ)法特征（如表格語(yǔ)法前面就要空行后才有效果），應(yīng)用時(shí)多加注意。

• 水平分割線

【語(yǔ)法】3個(gè)及以上的 星號(hào)***或 減號(hào)---或 下底線___來表示。

【示例】

【說明】建議只固定選用一個(gè)，如三個(gè)星號(hào)***為標(biāo)準(zhǔn)，用減號(hào)---容易和副標(biāo)題搞混。

• 強(qiáng)制換行

【語(yǔ)法】在行尾輸入兩個(gè)空格
【示例】（好像沒有效果）
這句話
不會(huì)
換行

這句話
會(huì)
換行（這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這
里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字）

MD中級(jí)語(yǔ)法教程

鏈接

• 網(wǎng)頁(yè)鏈接（內(nèi)聯(lián)風(fēng)格）

【語(yǔ)法】 [鏈接文字](http://鏈接地址)"（空格）鼠標(biāo)懸停顯示文字（可選）"，"（空格）鼠標(biāo)懸停顯示文字"非必須項(xiàng)，在pc瀏覽器中能看到效果，手機(jī)移動(dòng)端因無鼠標(biāo)效果無法直接體現(xiàn)。
【示例】這是去往 本人博客 的鏈接。

• 鏈接的快速定義

【語(yǔ)法】

前面文檔中引用鏈接的語(yǔ)法為：
[鏈接文字][id]
前后id要匹配一致，一般為數(shù)字，這樣可以在文檔的其他任意地方快速插入這個(gè)鏈接。

后面定義鏈接的語(yǔ)法為：
[id]:（空格）http://鏈接地址（空格）"鼠標(biāo)懸停顯示文字（可選）"
后面的語(yǔ)法必須在列首并單獨(dú)一行，適合前期不知道網(wǎng)址，后面再加入的情況。

【示例】
大家去訪問MarkdownX 官方網(wǎng)站吧，這個(gè)也是MDX官網(wǎng)哦。

• 鏈接的自動(dòng)展示

你可以直接輸入鏈接地址，它可以直接識(shí)別這個(gè)鏈接。
http://markdownx.ryeeeeee.com

• Email 鏈接

【語(yǔ)法】直接<郵箱號(hào)地址>即可
【示例】作者的 email 鏈接.

列表

• 有序列表:

【語(yǔ)法】直接數(shù)字加英文句點(diǎn)加空格（最多三個(gè)空格）和文字
【示例】有序單層列表

520. 列表項(xiàng)1（第一項(xiàng)數(shù)字一定要為“520”）
521. 列表項(xiàng)2（其實(shí)我前面的標(biāo)的數(shù)字是“201314”）
522. 列表項(xiàng)3（其實(shí)我前面的標(biāo)的數(shù)字是“20161130”）

【說明】后面的不必在意數(shù)字從小到大的排序，顯示時(shí)會(huì)自動(dòng)排序，有智能的亂序糾正功能，非常貼心。數(shù)字前面加了空格，排序會(huì)變成羅馬數(shù)字形式。

• 無序列表:

【語(yǔ)法】文字前面加 星號(hào)空格*（空格）或 短橫空格-（空格）或 加號(hào)+（空格）表示
【示例】無序單層列表

• 列表項(xiàng) 1（前面未加空格是 實(shí)心點(diǎn)）

• 列表項(xiàng) 2（前面未加空格是 實(shí)心點(diǎn)）

• 多重列表:

【語(yǔ)法】單層列表項(xiàng)縮進(jìn)1個(gè)空格就可以往后面疊加子層的列表
【示例】

1. 首層列表項(xiàng)（有序）
2. 第二層列表項(xiàng)1(嵌套的列表可以是有序的 )
3. 第二層列表項(xiàng)2(格式和正常的有序、無序列表沒有差異)
4. 第三層列表項(xiàng)1
5. 第三層列表項(xiàng)2
   1.第四層列表項(xiàng)1
   1.第五層列表項(xiàng)2

• 首層列表項(xiàng)第四層列表項(xiàng)2（無序）
• 嵌套的列表可以是無序的
  • 這個(gè)嵌套的列表項(xiàng)有4個(gè)空格的縮進(jìn)，因?yàn)樗母噶斜眄?xiàng)自身就帶有2個(gè)空格的縮進(jìn)
  • 還允許更多層的嵌套，反正在前面一層中再空行后加兩空格就行
  • 列表項(xiàng) 3（前面加了 空格是空心，且會(huì)后置）
    • 列表項(xiàng) 4（前面加了 空格是空心，且會(huì)后置）

引用

• 文字引用

【語(yǔ)法】段落前面添加大于號(hào)和空格> （空格），就能夠形成引用段落。
【示例1】單層引用

青松 （陳毅）
大雪壓青松，青松挺且直。
要知松高潔，待到雪化時(shí)。

【示例2】多層引用

這是第一層的文字引用

這是第二層嵌套的引用

這是第三層的嵌套的引用

第9層，第N層就在前面添加N個(gè)>（空格）表示

添加影像附件

• 插入圖片

【語(yǔ)法】使用 ![圖片描述](圖片網(wǎng)絡(luò)/本地圖片地址)（空格）“鼠標(biāo)懸停顯示文字（可選）”

【示例】

我的頭像

• 圖片鏈接的定義

【語(yǔ)法】

  前面文檔中引用的語(yǔ)法：
![圖片描述]本地/網(wǎng)絡(luò)圖片地址 "鼠標(biāo)懸停顯示文字（可選）"

前后id要匹配一致，一般為數(shù)字，這樣可以在文檔的其他任意地方快速插入這張圖片。
這是一張本地圖：/url/to/img.jpg


   后面定義鏈接的語(yǔ)法為：
![圖片描述][id]：本地/網(wǎng)絡(luò)圖片地址 "鼠標(biāo)懸停顯示文字（可選）"
后面的語(yǔ)法必須在列首并單獨(dú)一行

這是兩張圖片是相同的![我的圖片][id]，這張是![我的同胞兄弟][id]照片。

【示例】
[id]: https://www.zybuluo.com/static/img/my_head.jpg "鼠標(biāo)懸停顯示文字"

代碼塊

• 行內(nèi)（內(nèi)聯(lián)）代碼

【語(yǔ)法】 使用內(nèi)容 表示行內(nèi) 代碼塊。即 在文字左右使用反引號(hào)包含（鍵盤數(shù)字“1”前面的波浪號(hào)大寫狀態(tài)時(shí)能打出）。

【示例】
各位同學(xué)晚上好，我是你們敬愛的送晴老師，這次讓我們來聊聊 html5，本期我們邀請(qǐng)了重量級(jí)嘉賓馬化騰先生給我們講解，大家掌聲歡迎……
【說明】
和標(biāo)簽/關(guān)鍵詞的效果差不多，還可用于如按鍵Ctrl+F4，字母B，單詞F**K、短句Are you ok？等諸多行的應(yīng)用場(chǎng)景。能起到強(qiáng)調(diào)區(qū)分的作用。

• 定義型代碼塊

【語(yǔ)法】:（4空格），左側(cè)加一個(gè)可見的英文冒號(hào)和4個(gè)不可見的空格）
【示例】

: 這是代碼塊的定義（左側(cè)有一個(gè)可見的英文冒號(hào)和四個(gè)不可見的空格）

• 段落文本代碼塊

【語(yǔ)法】每行縮進(jìn)4個(gè)空格或 1個(gè) Tab表示
【示例】方法一

這是一個(gè)代碼塊，此行左側(cè)有四個(gè)不可見的空格。
這是代碼塊，會(huì)自動(dòng)添加行號(hào)，注意要與前面文字空行，
不然沒有引用效果，就是這么簡(jiǎn)單，非常實(shí)用呀。