標(biāo)準(zhǔn)md語法教程- Markdown從入門到精通 （送晴編寫）
tags: 送晴 Markdown 語法教程
寫在前面：
- 目的：這個(gè)文檔自身就是使用 Markdown 編寫的。Markdown 允許你通過編寫易讀、易寫的富文本格式，然后很方便就可以轉(zhuǎn)換成有效的 HTML。
- 本教程以一般方案的書寫習(xí)慣為便。致力于打造最全面的md語法教程，若發(fā)現(xiàn)錯(cuò)漏歡迎加QQ群聯(lián)系本人
- 應(yīng)用的軟件：以 XXX 軟件的語法為標(biāo)準(zhǔn)，其他軟件平臺(tái)部分語法規(guī)范不一樣的話，部分項(xiàng)將不能顯示，請(qǐng)知悉。
- 編寫整理本教程耗費(fèi)作者很多心血，轉(zhuǎn)載請(qǐng)保留出處，歡迎加QQ群
123456交流，并有各pc，安卓，mac各平臺(tái)md相關(guān)軟件和實(shí)用資料的下載。后期打算制作視頻教程哦-- 感謝原創(chuàng)作者和軟件開發(fā)者的無私共享。
- 本軟件全程使用md語法書寫，全部中文表述，充分考慮了國內(nèi)的小白用戶。
MD入門語法教程
標(biāo)題
-
主標(biāo)題：
【語法】主標(biāo)題文字 空行 ==（兩個(gè)及以上）
【示例】
主標(biāo)題文字（最高階標(biāo)題）
==
【說明】相當(dāng)于H1大綱標(biāo)題效果，一般在首行應(yīng)用和表示
-
副標(biāo)題：
【語法】副標(biāo)題文字 （空行） ---減號(hào)兩個(gè)及以上
【示例】
副標(biāo)題文字（第二階標(biāo)題）
--
【說明】相當(dāng)于H2大綱標(biāo)題效果
-
H1~H6大綱標(biāo)題
【語法】#（空格）文字 或 #（空格）文字 （空格）#） （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)簽
【語法】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)航
【語法】 在段落中填寫 [TOC] （toc小寫也可以）以顯示各標(biāo)題為結(jié)構(gòu)的目錄（大綱）導(dǎo)航。
【示例】
[TOC]
強(qiáng)調(diào)或突出
-
斜體
【語法】_斜體_ 或 *斜體* 在文字兩邊加 單下底線 或 單星號(hào)
【示例】 斜體 或 斜體
-
粗體
【語法】__粗體__ 或 **粗體** 在文字兩邊加 雙下底線 或 雙星號(hào)
【示例】 粗體 或 粗體
-
刪除線
【語法】~~刪除線~~ 在文字兩邊加 雙波浪號(hào)
【示例】這是帶有 刪除線 的文字
【說明】快速記憶：單斜雙粗兩波刪
-
下劃線
【語法 】 在空白行下方添加三條“-”橫線。（前面講過在文字下方添加“-”，實(shí)現(xiàn)的2級(jí)標(biāo)題）
【示例】
這是---下劃線---
你看到了嗎？
段落與分割
-
普通段落
【語法】用空行分隔，連著多個(gè)空行也是一個(gè)效果，只能空一行的間距。
【示例】
這是首行文字
這是尾行文字，實(shí)際中間我空了7行，但還是只顯示空了一行的效果。
【說明】有的語法要用到空行才有效果（如主標(biāo)題，列表），不空行的話默認(rèn)又是會(huì)跟隨上面語法特征（如表格語法前面就要空行后才有效果），應(yīng)用時(shí)多加注意。
-
水平分割線
【語法】3個(gè)及以上的 星號(hào)***或 減號(hào)---或 下底線___來表示。
【示例】
【說明】建議只固定選用一個(gè)，如三個(gè)星號(hào)***為標(biāo)準(zhǔn)，用減號(hào)---容易和副標(biāo)題搞混。
-
強(qiáng)制換行
【語法】在行尾輸入兩個(gè)空格
【示例】（好像沒有效果）
這句話
不會(huì)
換行
這句話
會(huì)
換行（這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這
里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字這里有很多個(gè)文字）
MD中級(jí)語法教程
鏈接
-
網(wǎng)頁鏈接（內(nèi)聯(lián)風(fēng)格）
【語法】 [鏈接文字](http://鏈接地址)"（空格）鼠標(biāo)懸停顯示文字（可選）"，"（空格）鼠標(biāo)懸停顯示文字"非必須項(xiàng)，在pc瀏覽器中能看到效果，手機(jī)移動(dòng)端因無鼠標(biāo)效果無法直接體現(xiàn)。
【示例】這是去往 本人博客 的鏈接。
-
鏈接的快速定義
【語法】
前面文檔中引用鏈接的語法為：
[鏈接文字][id]
前后id要匹配一致，一般為數(shù)字，這樣可以在文檔的其他任意地方快速插入這個(gè)鏈接。
后面定義鏈接的語法為：
[id]:（空格）http://鏈接地址（空格）"鼠標(biāo)懸停顯示文字（可選）"
后面的語法必須在列首并單獨(dú)一行，適合前期不知道網(wǎng)址，后面再加入的情況。
【示例】
大家去訪問MarkdownX 官方網(wǎng)站吧，這個(gè)也是MDX官網(wǎng)哦。
-
鏈接的自動(dòng)展示
你可以直接輸入鏈接地址，它可以直接識(shí)別這個(gè)鏈接。
http://markdownx.ryeeeeee.com
-
Email 鏈接
【語法】直接<郵箱號(hào)地址>即可
【示例】作者的 email 鏈接.
列表
-
有序列表:
【語法】直接數(shù)字加英文句點(diǎn)加空格（最多三個(gè)空格）和文字
【示例】有序單層列表
- 列表項(xiàng)1（第一項(xiàng)數(shù)字一定要為“520”）
- 列表項(xiàng)2（其實(shí)我前面的標(biāo)的數(shù)字是“201314”）
- 列表項(xiàng)3（其實(shí)我前面的標(biāo)的數(shù)字是“20161130”）
【說明】后面的不必在意數(shù)字從小到大的排序，顯示時(shí)會(huì)自動(dòng)排序，有智能的亂序糾正功能，非常貼心。數(shù)字前面加了空格，排序會(huì)變成羅馬數(shù)字形式。
-
無序列表:
【語法】文字前面加 星號(hào)空格*（空格）或 短橫空格-（空格）或 加號(hào)+（空格）表示
【示例】無序單層列表
列表項(xiàng) 1（前面未加空格是 實(shí)心點(diǎn)）
列表項(xiàng) 2（前面未加空格是 實(shí)心點(diǎn)）
-
多重列表:
【語法】單層列表項(xiàng)縮進(jìn)1個(gè)空格就可以往后面疊加子層的列表
【示例】
- 首層列表項(xiàng)（有序）
- 第二層列表項(xiàng)1(嵌套的列表可以是有序的 )
- 第二層列表項(xiàng)2(格式和正常的有序、無序列表沒有差異)
- 第三層列表項(xiàng)1
- 第三層列表項(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ì)后置）
引用
-
文字引用
【語法】段落前面添加大于號(hào)和空格> （空格），就能夠形成引用段落。
【示例1】單層引用
青松 （陳毅）
大雪壓青松，青松挺且直。
要知松高潔，待到雪化時(shí)。
【示例2】多層引用
這是第一層的文字引用
這是第二層嵌套的引用
這是第三層的嵌套的引用
第9層，第N層就在前面添加N個(gè)
>（空格）表示
添加影像附件
-
插入圖片
【語法】使用 絡(luò)/本地圖片地址)（空格）“鼠標(biāo)懸停顯示文字（可選）”
【示例】
-
圖片鏈接的定義
【語法】
前面文檔中引用的語法：
![圖片描述]本地/網(wǎng)絡(luò)圖片地址 "鼠標(biāo)懸停顯示文字（可選）"
前后id要匹配一致，一般為數(shù)字，這樣可以在文檔的其他任意地方快速插入這張圖片。
這是一張本地圖：/url/to/img.jpg
后面定義鏈接的語法為：
![圖片描述][id]：本地/網(wǎng)絡(luò)圖片地址 "鼠標(biāo)懸停顯示文字（可選）"
后面的語法必須在列首并單獨(dú)一行
這是兩張圖片是相同的![我的圖片][id]，這張是![我的同胞兄弟][id]照片。
【示例】
[id]: https://www.zybuluo.com/static/img/my_head.jpg "鼠標(biāo)懸停顯示文字"
代碼塊
-
行內(nèi)（內(nèi)聯(lián)）代碼
【語法】 使用內(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ū)分的作用。
-
定義型代碼塊
【語法】:（4空格），左側(cè)加一個(gè)可見的英文冒號(hào)和4個(gè)不可見的空格）
【示例】
: 這是代碼塊的定義（左側(cè)有一個(gè)可見的英文冒號(hào)和四個(gè)不可見的空格）
-
段落文本代碼塊
【語法】每行縮進(jìn)4個(gè)空格或 1個(gè) Tab表示
【示例】方法一
這是一個(gè)代碼塊，此行左側(cè)有四個(gè)不可見的空格。
這是代碼塊，會(huì)自動(dòng)添加行號(hào)，注意要與前面文字空行，
不然沒有引用效果，就是這么簡單，非常實(shí)用呀。