參考幾個教程:
教程:
https://blog.csdn.net/renlzrz/article/details/83545521
在線轉換工具:
http://tool.oschina.net/markdown/
教程:
https://www.appinn.com/markdown/
https://sspai.com/post/25137
寫在前面:
目的:這個文檔自身就是使用 Markdown 編寫的。Markdown 允許你通過編寫易讀、易寫的富文本格式,然后很方便就可以轉換成有效的 HTML。
本教程以一般方案的書寫習慣為便。致力於打造最全面的md語法教程,若發現錯漏歡迎加QQ群聯系本人
應用的軟件:以 XXX 軟件的語法為標准,其他軟件平台部分語法規范不一樣的話,部分項將不能顯示,請知悉。
編寫整理本教程耗費作者很多心血,轉載請保留出處,歡迎加QQ群123456交流,並有各pc,安卓,mac各平台md相關軟件和實用資料的下載。后期打算制作視頻教程哦-
感謝原創作者和軟件開發者的無私共享。
本軟件全程使用md語法書寫,全部中文表述,充分考慮了國內的小白用戶。
MD入門語法教程
如果想改變圖片大小,把粘貼生成后的圖片源地址粘到以下代碼對應處(可以不指定高度)
<img src="./xxx.png" width = "300" height = "200" alt="圖片名稱" align=center />
標題
主標題:
【語法】主標題文字 空行 ==(兩個及以上)
【示例】
主標題文字(最高階標題)
【說明】相當於H1大綱標題效果,一般在首行應用和表示
副標題:
【語法】副標題文字 (空行) ---減號兩個及以上
【示例】
副標題文字(第二階標題)
【說明】相當於H2大綱標題效果
H1~H6大綱標題
【語法】#(空格)文字 或 #(空格)文字 (空格)#) (1-6等級分別在文字前加對應數量#,后面的#為可選,不加效果也一樣。
【示例】
大綱標題文字 H1(等同 主標題)
大綱標題文字 H2(等同 副標題)
大綱標題文字 H3
大綱標題文字 H4
大綱標題文字 H5
大綱標題文字 H6
####### 大綱標題文字 H7(最多6階)
【說明】最多6個等級的大綱標題,后面加上同等數量“(空格)#”效果也一樣
標簽
【語法】TAGS:內容 或直接標簽:內容 ,即 在編輯區任意行的列首位置輸入tags/標簽:關鍵詞1 關鍵詞2 , 多個用空格隔開。
【示例】
標簽: 教程 Markdown
或者
Tags: 教程 2016年 重要的
目錄(大綱)導航
【語法】 在段落中填寫
【示例】
強調或突出
斜體
【語法】斜體 或 斜體 在文字兩邊加 單下底線 或 單星號
【示例】 斜體 或 斜體
粗體
【語法】粗體 或 粗體 在文字兩邊加 雙下底線 或 雙星號
【示例】 粗體 或 粗體
刪除線
【語法】刪除線 在文字兩邊加 雙波浪號
【示例】這是帶有 刪除線 的文字
【說明】快速記憶:單斜雙粗兩波刪
下划線
【語法 】 在空白行下方添加三條“-”橫線。(前面講過在文字下方添加“-”,實現的2級標題)
【示例】
這是---下划線---
你看到了嗎?
段落與分割
普通段落
【語法】用空行分隔,連着多個空行也是一個效果,只能空一行的間距。
【示例】
這是首行文字
這是尾行文字,實際中間我空了7行,但還是只顯示空了一行的效果。
【說明】有的語法要用到空行才有效果(如主標題,列表),不空行的話默認又是會跟隨上面語法特征(如表格語法前面就要空行后才有效果),應用時多加注意。
水平分割線
【語法】3個及以上的 星號***或 減號---或 下底線___來表示。
【示例】
【說明】建議只固定選用一個,如三個星號***為標准,用減號---容易和副標題搞混。
強制換行
【語法】在行尾輸入兩個空格
【示例】(好像沒有效果)
這句話
不會
換行
這句話
會
換行(這里有很多個文字這里有很多個文字這里有很多個文字這里有很多個文字這里有很多個文字這里有很多個文字這里有很多個文字這里有很多個文字這
里有很多個文字這里有很多個文字這里有很多個文字這里有很多個文字)
MD中級語法教程
鏈接
網頁鏈接(內聯風格)
【語法】 鏈接文字"(空格)鼠標懸停顯示文字(可選)","(空格)鼠標懸停顯示文字"非必須項,在pc瀏覽器中能看到效果,手機移動端因無鼠標效果無法直接體現。
【示例】這是去往 本人博客 的鏈接。
鏈接的快速定義
【語法】
前面文檔中引用鏈接的語法為:
[鏈接文字][id]
前后id要匹配一致,一般為數字,這樣可以在文檔的其他任意地方快速插入這個鏈接。
后面定義鏈接的語法為:
[id]:(空格)http://鏈接地址(空格)"鼠標懸停顯示文字(可選)"
后面的語法必須在列首並單獨一行,適合前期不知道網址,后面再加入的情況。
【示例】
大家去訪問MarkdownX 官方網站吧,這個也是MDX官網哦。
鏈接的自動展示
你可以直接輸入鏈接地址,它可以直接識別這個鏈接。
http://markdownx.ryeeeeee.com
Email 鏈接
【語法】直接<郵箱號地址>即可
【示例】作者的 email 鏈接.
列表
有序列表:
【語法】直接數字加英文句點加空格(最多三個空格)和文字
【示例】有序單層列表
列表項1(第一項數字一定要為“520”)
列表項2(其實我前面的標的數字是“201314”)
列表項3(其實我前面的標的數字是“20161130”)
【說明】后面的不必在意數字從小到大的排序,顯示時會自動排序,有智能的亂序糾正功能,非常貼心。數字前面加了空格,排序會變成羅馬數字形式。
無序列表:
【語法】文字前面加 星號空格*(空格)或 短橫空格-(空格)或 加號+(空格)表示
【示例】無序單層列表
列表項 1(前面未加空格是 實心點)
列表項 2(前面未加空格是 實心點)
多重列表:
【語法】單層列表項縮進1個空格就可以往后面疊加子層的列表
【示例】
首層列表項(有序)
第二層列表項1(嵌套的列表可以是有序的 )
第二層列表項2(格式和正常的有序、無序列表沒有差異)
第三層列表項1
第三層列表項2
1.第四層列表項1
1.第五層列表項2
首層列表項第四層列表項2(無序)
嵌套的列表可以是無序的
這個嵌套的列表項有4個空格的縮進,因為它的父列表項自身就帶有2個空格的縮進
還允許更多層的嵌套,反正在前面一層中再空行后加兩空格就行
列表項 3(前面加了 空格是空心,且會后置)
列表項 4(前面加了 空格是空心,且會后置)
引用
文字引用
【語法】段落前面添加大於號和空格> (空格),就能夠形成引用段落。
【示例1】單層引用
青松 (陳毅)
大雪壓青松,青松挺且直。
要知松高潔,待到雪化時。
【示例2】多層引用
這是第一層的文字引用
這是第二層嵌套的引用
這是第三層的嵌套的引用
第9層,第N層就在前面添加N個>(空格)表示
添加影像附件
插入圖片
【語法】使用 (空格)“鼠標懸停顯示文字(可選)”
【示例】
我的頭像我的頭像
圖片鏈接的定義
【語法】
前面文檔中引用的語法:
![圖片描述]本地/網絡圖片地址 "鼠標懸停顯示文字(可選)"
前后id要匹配一致,一般為數字,這樣可以在文檔的其他任意地方快速插入這張圖片。
這是一張本地圖:/url/to/img.jpg
后面定義鏈接的語法為:
![圖片描述][id]:本地/網絡圖片地址 "鼠標懸停顯示文字(可選)"
后面的語法必須在列首並單獨一行
這是兩張圖片是相同的![我的圖片][id],這張是![我的同胞兄弟][id]照片。
【示例】
[id]: https://www.zybuluo.com/static/img/my_head.jpg "鼠標懸停顯示文字"
代碼塊
行內(內聯)代碼
【語法】 使用內容 表示行內 代碼塊。即 在文字左右使用反引號包含(鍵盤數字“1”前面的波浪號大寫狀態時能打出)。
【示例】
各位同學晚上好,我是你們敬愛的送晴老師,這次讓我們來聊聊 html5,本期我們邀請了重量級嘉賓馬化騰先生給我們講解,大家掌聲歡迎……
【說明】
和標簽/關鍵詞的效果差不多,還可用於如按鍵Ctrl+F4,字母B,單詞F**K、短句Are you ok?等諸多行的應用場景。能起到強調區分的作用。
定義型代碼塊
【語法】:(4空格),左側加一個可見的英文冒號和4個不可見的空格)
【示例】
: 這是代碼塊的定義(左側有一個可見的英文冒號和四個不可見的空格)
段落文本代碼塊
【語法】每行縮進4個空格或 1個 Tab表示
【示例】方法一
這是一個代碼塊,此行左側有四個不可見的空格。
這是代碼塊,會自動添加行號,注意要與前面文字空行,
不然沒有引用效果,就是這么簡單,非常實用呀。