前言
寫過(guò)博客或者github上面的文檔的,應(yīng)該知道Markdown語(yǔ)法的重要性,不知道的朋友們也別著急,一篇博客輕松搞定Markdown語(yǔ)法。話說(shuō)這個(gè)語(yǔ)法超級(jí)簡(jiǎn)單,一看就會(huì),不信你點(diǎn)進(jìn)來(lái)看看。
1.快捷鍵
功能 | 快捷鍵 |
---|---|
加粗 | Ctrl + B |
斜體 | Ctrl + I |
引用 | Ctrl + Q |
插入鏈接 | Ctrl + L |
插入代碼 | Ctrl + K |
插入圖片 | Ctrl + G |
提升標(biāo)題 | Ctrl + H |
有序列表 | Ctrl + O |
無(wú)序列表 | Ctrl + U |
橫線 | Ctrl + R |
撤銷 | Ctrl + Z |
重做 | Ctrl + Y |
2. 基本語(yǔ)法
2.1 字體設(shè)置斜體、粗體、刪除線
*這里是文字*
_這里是文字_
**這里是文字**
***這里是文字***
~~這里是文字~~
2.2 分級(jí)標(biāo)題
寫法1:
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題
這個(gè)寫法和 **文字**效果是一樣的
寫法2:
這是一個(gè)一級(jí)標(biāo)題
============================
或者
二級(jí)標(biāo)題
– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –
2.3 鏈接
(1)插入本地圖片鏈接
語(yǔ)法規(guī)則,有兩種寫法:
注意:這個(gè)圖片描述可以不寫。
示例圖如下:
(2)插入互聯(lián)網(wǎng)上圖片
語(yǔ)法規(guī)則:
注意:這個(gè)圖片描述可以不寫。
示例如下:
(3)自動(dòng)連接
Markdown 支持以比較簡(jiǎn)短的自動(dòng)鏈接形式來(lái)處理網(wǎng)址和電子郵件信箱,只要是用<>包起來(lái), Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接。也可以直接寫,也是可以顯示成鏈接形式的
例如:
2.4 分割線
你可以在一行中用三個(gè)以上的星號(hào)(*)、減號(hào)(-)、底線(_)來(lái)建立一個(gè)分隔線,行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格。
2.5 代碼塊
對(duì)于程序員來(lái)說(shuō)這個(gè)功能是必不可少的,插入程序代碼的方式有兩種,一種是利用縮進(jìn)(tab), 另一種是利用英文“`”符號(hào)(一般在ESC鍵下方,和~同一個(gè)鍵)包裹代碼。
(1)代碼塊:縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符。效果如下:
(2)行內(nèi)式:如果在一個(gè)行內(nèi)需要引用代碼,只要用反引號(hào)`引起來(lái)就好(一般在ESC鍵下方,和~同一個(gè)鍵)
(3)多行代碼塊與語(yǔ)法高亮:在需要高亮的代碼塊的前一行及后一行使用三個(gè)單反引號(hào)“`”包裹,就可以了。
示例如下:
(4)代碼塊里面包含html代碼
在代碼區(qū)塊里面, & 、 < 和 > 會(huì)自動(dòng)轉(zhuǎn)成 HTML 實(shí)體,這樣的方式讓你非常容易使用 Markdown 插入范例用的 HTML 原始碼,只需要復(fù)制貼上,剩下的 Markdown 都會(huì)幫你處理。
注意:簡(jiǎn)書(shū)代碼塊里不支持html。
示例如下:
2.6 引用
在被引用的文本前加上>符號(hào),以及一個(gè)空格就可以了,如果只輸入了一個(gè)>符號(hào)會(huì)產(chǎn)生一個(gè)空白的引用。
(1)基本使用
使用如下圖所示:
(2)引用的嵌套使用
使用如圖所示:
(3)引用其它要素
引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法,包括標(biāo)題、列表、代碼區(qū)塊等。
使用如圖所示:
2.7 列表
(1)無(wú)序列表
使用 *,+,- 表示無(wú)序列表。
注意:符號(hào)后面一定要有一個(gè)空格,起到縮進(jìn)的作用。
(2)有序列表
使用數(shù)字和一個(gè)英文句點(diǎn)表示有序列表。
注意:英文句點(diǎn)后面一定要有一個(gè)空格,起到縮進(jìn)的作用。
(3)無(wú)序列表和有序列表同時(shí)使用
(4)列表和其它要素混合使用
列表不光可以單獨(dú)使用,也可以使用其他的 Markdown 語(yǔ)法,包括標(biāo)題、引用、代碼區(qū)塊等。
注意事項(xiàng):
(1)加粗效果不能直接用于列表標(biāo)題里面,但是可以嵌套在列表里面混合使用。
(2)列表中包含代碼塊(前面加2個(gè)tab或者8個(gè)空格,并且需要空一行,否則不顯示)。
.
使用示例如下圖:
(5)注意事項(xiàng)
在使用列表時(shí),只要是數(shù)字后面加上英文的點(diǎn),就會(huì)無(wú)意間產(chǎn)生列表,比如2017.12.30 這時(shí)候想表達(dá)的是日期,有些軟件把它被誤認(rèn)為是列表。解決方式:在每個(gè)點(diǎn)前面加上就可以了。
如下圖所示:
2.8 表格
表格的基本寫法很簡(jiǎn)單,就跟表格的形狀很相似:
表格對(duì)齊方式:我們可以指定表格單元格的對(duì)齊方式,冒號(hào)在左邊表示左對(duì)齊,右邊表示有對(duì)齊,兩邊都有表示居中。
如下圖所示:
3. 常用技巧
3.1 換行
方法1: 連續(xù)兩個(gè)以上空格+回車
方法2:使用html語(yǔ)言換行標(biāo)簽:
3.2 縮進(jìn)字符
不斷行的空白格 或 半角的空格 ? 或 ?全角的空格 ? 或 ?
3.3 特殊符號(hào)
(1)對(duì)于 Markdown 中的語(yǔ)法符號(hào),前面加反斜線即可顯示符號(hào)本身。
示例如下:
(2)其他特殊字符,示例如下:
想知道字符對(duì)應(yīng)的Unicode碼,可以看這個(gè)網(wǎng)站:https://unicode-table.com/cn/
附上幾個(gè)工具對(duì)特殊字符的支持的對(duì)比圖:
3.4 字體、字號(hào)與顏色
Markdown是一種可以使用普通文本編輯器編寫的標(biāo)記語(yǔ)言,通過(guò)類似HTML的標(biāo)記語(yǔ)法,它可以使普通文本內(nèi)容具有一定的格式。但是它本身是不支持修改字體、字號(hào)與顏色等功能的!
CSDN-markdown編輯器是其衍生版本,擴(kuò)展了Markdown的功能(如表格、腳注、內(nèi)嵌HTML等等)!對(duì),就是內(nèi)嵌HTML,接下來(lái)要講的功能就需要使用內(nèi)嵌HTML的方法來(lái)實(shí)現(xiàn)。
字體,字號(hào)和顏色編輯如下代碼
具體顏色分類及標(biāo)記請(qǐng)看下表:
3.5 鏈接的高級(jí)操作
鏈接的高級(jí)操作(這個(gè)需要掌握一下,很有用)
1.行內(nèi)式
這個(gè)在上文第二條基本語(yǔ)法的 鏈接這個(gè)小節(jié)已經(jīng)過(guò),這里就不繼續(xù)講解了。
2.參考式鏈接
在文檔要插入圖片的地方寫![圖片或網(wǎng)址鏈接][標(biāo)記](méi),在文檔的最后寫上[標(biāo)記](méi):圖片地址 “標(biāo)題”。(最后這個(gè)”標(biāo)題”可以不填寫)
示例如下:
3.內(nèi)容目錄
在段落中填寫 [TOC] 以顯示全文內(nèi)容的目錄結(jié)構(gòu)。
4.錨點(diǎn)
錨點(diǎn)其實(shí)就是頁(yè)內(nèi)超鏈接。比如我這里寫下一個(gè)錨點(diǎn),點(diǎn)擊回到目錄,就能跳轉(zhuǎn)到目錄。 在目錄中點(diǎn)擊這一節(jié),就能跳過(guò)來(lái)。
注意:在簡(jiǎn)書(shū)中使用錨點(diǎn)時(shí),點(diǎn)擊會(huì)打開(kāi)一個(gè)新的當(dāng)前頁(yè)面,雖然錨點(diǎn)用的不是很舒服,但是可以用注腳實(shí)現(xiàn)這個(gè)功能。
語(yǔ)法說(shuō)明:
在你準(zhǔn)備跳轉(zhuǎn)到的指定標(biāo)題后插入錨點(diǎn){#標(biāo)記},然后在文檔的其它地方寫上連接到錨點(diǎn)的鏈接。
使用如下圖所示:
5.注腳
語(yǔ)法說(shuō)明:
在需要添加注腳的文字后加上腳注名字[^注腳名字],稱為加注。 然后在文本的任意位置(一般在最后)添加腳注,腳注前必須有對(duì)應(yīng)的腳注名字。
示例如下:
注:
腳注自動(dòng)被搬運(yùn)到最后面,請(qǐng)到文章末尾查看,并且腳注后方的鏈接可以直接跳轉(zhuǎn)回到加注的地方。
由于簡(jiǎn)書(shū)不支持錨點(diǎn),所以可以用注腳實(shí)現(xiàn)頁(yè)面內(nèi)部的跳轉(zhuǎn)。
3.6 背景色
Markdown本身不支持背景色設(shè)置,需要采用內(nèi)置html的方式實(shí)現(xiàn):借助 table, tr, td 等表格標(biāo)簽的 bgcolor 屬性來(lái)實(shí)現(xiàn)背景色的功能。舉例如下:
<table><tr><td bgcolor=orange>背景色是:orange</td></tr></table>
3.7 emoji表情符號(hào)
emoji表情使用:EMOJICODE:的格式,詳細(xì)列表可見(jiàn)
https://www.webpagefx.com/tools/emoji-cheat-sheet/
當(dāng)然現(xiàn)在很多markdown工具或者網(wǎng)站都不支持。
下面列出幾個(gè)平臺(tái)的對(duì)比:
工具或網(wǎng)站 | 是否支持emoji表情符號(hào) |
---|---|
簡(jiǎn)書(shū) | 否 |
MarkDownPad | 否(不知道付費(fèi)版是否支持) |
有道云筆記 | 否 |
zybuluo.com | 否 |
github | 是 |
4. 高端用法
4.1 Latex數(shù)學(xué)公式
使用LaTex數(shù)學(xué)公式
1.行內(nèi)公式:使用兩個(gè)”$”符號(hào)引用公式:
$公式$
2.行間公式:使用兩對(duì)“$$”符號(hào)引用公式:
4.2 流程圖
這里簡(jiǎn)單介紹一下流程圖的語(yǔ)法,僅作為了解,如下圖所示:
4.3 制作一份待辦事宜—-Todo 列表
4.4 繪制 序列圖
4.5 繪制 甘特圖
5. Markdown工具
1.markdownpad軟件,就是利用markdown語(yǔ)言寫筆記的。官網(wǎng)下載地址:http://markdownpad.com/
軟件安裝之后的示意圖如下圖所示:
2.有道云筆記支持markdownpad語(yǔ)法。官方網(wǎng)址:http://note.youdao.com/ 它有在線網(wǎng)頁(yè)版以及PC端可以下載。當(dāng)然有道云筆記也支持html語(yǔ)法。
網(wǎng)頁(yè)版使用markdown示例圖如下:
3.在線編輯markdown https://www.zybuluo.com/mdeditor