前言
學(xué)習(xí)目的
1） 更方便做筆記
2） 做完的筆記可以直接在博客上發(fā)布
學(xué)習(xí)路線
1） 在嗶哩嗶哩上查找Markdown學(xué)習(xí)視頻
2） 邊練習(xí)邊總結(jié)
3） 學(xué)習(xí)筆記
資料定位
??以后需要用時(shí)可直接查看指令。
一 簡介
1.1 基本信息
??Markdown 是一種輕量級(jí)標(biāo)記語言，它允許人們使用易讀易寫的純文本格式編寫文檔。Markdown 語言在 2004 由約翰·格魯伯（英語：John Gruber）創(chuàng)建。
??Markdown 編寫的文檔可以導(dǎo)出 HTML 、Word、圖像、PDF、Epub 等多種格式的文檔。Markdown 編寫的文檔后綴為.md, .markdown。
??Markdown能被用來撰寫電子書，如：Gitbook；還能用來寫博客。
1.2 編輯器
??有在線編輯器以及客戶端編輯器軟件，如Typora。
二 基本指令
2.1 標(biāo)題
??快使用井號(hào)#。
? 指令：
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題
2.2 段落
??Markdown段落沒有特殊格式，直接編寫文字即可，段落的換行是使用兩個(gè)以上空格加上回車或者在段落后面空一行也可以表示重新開始一個(gè)段落。
2.3 字體
??用星號(hào)*或者底線_
? 指令：
*斜體文本*
_斜體文本_
**粗體文本**
__粗體文本__
***粗斜體文本***
___粗斜體文本___
2.4 分割線
??可以在一行中用三個(gè)以上的星號(hào)、減號(hào)、底線來建立一個(gè)分隔線，行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格。下面每種寫法都可以建立分隔線：
? 指令：
***
* * *
*****
- - -
----------
2.5 刪除線
???文字兩端加上兩個(gè)波浪線~~
? 指令：
~~刪掉我吧~~
2.6 下劃線
??下劃線可以通過HTML的u標(biāo)簽來實(shí)現(xiàn)
? 指令：
<u>我是誰</u>
2.7 腳注
??腳注是誰？是，對(duì)文本的補(bǔ)充
? 指令：
[^我是腳注]
? 舉個(gè)栗子：
我是誰[^1]
[^1]: 我是腳注
2.8 列表
A 無序列表
??無序列表使用星號(hào)*、加號(hào)+或是減號(hào)-作為列表標(biāo)記：
? 指令：
* 第一項(xiàng)
* 第二項(xiàng)
* 第三項(xiàng)
+ 第一項(xiàng)
+ 第二項(xiàng)
+ 第三項(xiàng)
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
B 有序列表
??有序列表使用數(shù)字并加上點(diǎn)號(hào).來表示，如：
? 指令：
1. 第一項(xiàng)
2. 第二項(xiàng)
3. 第三項(xiàng)
C 列表嵌套
??列表嵌套只需在子列表中的選項(xiàng)添加四個(gè)空格即可：
? 指令：
1. 第一項(xiàng)：
- 第一項(xiàng)嵌套的第一個(gè)元素
- 第一項(xiàng)嵌套的第二個(gè)元素
2. 第二項(xiàng)：
- 第二項(xiàng)嵌套的第一個(gè)元素
- 第二項(xiàng)嵌套的第二個(gè)元素
??實(shí)際操作時(shí)，更簡單，和WORD有點(diǎn)相似。
2.9 區(qū)塊
??區(qū)塊引用是在段落開頭使用西文半角大于號(hào) > ，然后后面緊跟一個(gè)空格符號(hào)：
> 我是誰
> 菜花，我是區(qū)塊啊！
A 區(qū)塊嵌套
??另外區(qū)塊是可以嵌套的，一個(gè) > 符號(hào)是最外層，兩個(gè)>符號(hào)是第一層嵌套，以此類推：
> 區(qū)塊
> > 區(qū)塊兒
> > > 區(qū)塊孫
B 區(qū)塊中用列表
??區(qū)塊中使用列表實(shí)例如下：
> 區(qū)塊中使用列表
> 1. 第一項(xiàng)
> 2. 第二項(xiàng)
> + 第一項(xiàng)
> + 第二項(xiàng)
> + 第三項(xiàng)
C 列表中用區(qū)塊
??如果要在列表項(xiàng)目內(nèi)放進(jìn)區(qū)塊，那么就需要在>前添加四個(gè)空格的縮進(jìn)。
* 第一項(xiàng)
> 我是區(qū)塊
> 好巧，我也是
* 第二項(xiàng)
??實(shí)際列表應(yīng)用也沒寫的這么復(fù)雜，水到渠成。
2.10 代碼
??如果是段落上的一個(gè)函數(shù)或片段的代碼可以用反引號(hào)`把它包起來。（驚了，我沒法用代碼的形式把反引號(hào)包起來）
這個(gè)`我是誰`有病
A 代碼區(qū)塊
??可以有三種方法表示代碼區(qū)塊，且可以指定一種語言（也可以不指定）
方法一： 代碼區(qū)塊使用 4 個(gè)空格
方法二： 一個(gè)制表符（Tab 鍵）或者用。
方法三： 用三個(gè)反引號(hào) ``` 包裹一段代碼
2.10 鏈接
??鏈接使用方法如下：
[鏈接名稱](鏈接地址)
或者
<鏈接地址>
??高級(jí)鏈接
鏈接也可以用變量來代替，文檔末尾附帶變量地址：
這個(gè)鏈接用 1 作為網(wǎng)址變量 [Google][1]
這個(gè)鏈接用 runoob 作為網(wǎng)址變量 [Runoob][runoob]
然后在文檔的結(jié)尾為變量賦值（網(wǎng)址）
[1]: http://www.google.com/
[runoob]: http://www.runoob.com/
2.11 圖片
??Markdown在使用網(wǎng)絡(luò)圖片時(shí)，一般是右鍵復(fù)制網(wǎng)絡(luò)圖片，然后直接粘貼到Markdown編輯器中即可完成圖片的導(dǎo)入。
A 圖片語法：
[圖片上傳失敗...(image-5f17e7-1583244273246)]
[圖片上傳失敗...(image-c7bb0d-1583244273247)]
1） 開頭一個(gè)感嘆號(hào) !
2）接著一個(gè)方括號(hào)，里面放上圖片的替代文字
3） 接著一個(gè)普通括號(hào)，里面放上圖片的網(wǎng)址，最后還可以用引號(hào)包住并加上選擇性的 'title' 屬性的文字。
B 像網(wǎng)址那樣對(duì)圖片網(wǎng)址使用變量
這個(gè)鏈接用 1 作為網(wǎng)址變量 [RUNOOB][1].
然后在文檔的結(jié)尾為變量賦值（網(wǎng)址）
[1]: http://static.runoob.com/images/runoob-logo.png
C 圖片的高度和寬度
??Markdown 還沒有辦法指定圖片的高度與寬度，如果你需要的話，你可以使用普通的 img 標(biāo)簽。
? 語法格式：
<img src="http://static.runoob.com/images/runoob-logo.png" width="50%">
2.12 表格
???Markdown 制作表格使用 | 來分隔不同的單元格，使用 - 來分隔表頭和其他行。（然而簡書的Markdown還沒有表格格式）
A 語法格式：
| 表頭 | 表頭 |
| ---- | ---- |
| 單元格 | 單元格 |
| 單元格 | 單元格 |
B 對(duì)齊方式
-:設(shè)置內(nèi)容和標(biāo)題欄居右對(duì)齊。:-設(shè)置內(nèi)容和標(biāo)題欄居左對(duì)齊。:-:設(shè)置內(nèi)容和標(biāo)題欄居中對(duì)齊。
2.13 公式
??當(dāng)你需要在編輯器中插入數(shù)學(xué)公式時(shí)，可以使用兩個(gè)美元符$$ 包裹 TeX 或 LaTeX 格式的數(shù)學(xué)公式來實(shí)現(xiàn)。提交后，問答和文章頁會(huì)根據(jù)需要加載 Mathjax 對(duì)數(shù)學(xué)公式進(jìn)行渲染。
? 【注】：
? 使用MathType編輯好公式后，可以直接轉(zhuǎn)換為LaTex代碼
三 技巧
3.1 支持的HTML元素
??不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽，都可以直接在文檔里面用 HTML 撰寫。
目前支持的 HTML 元素有：
<kbd> <b> <i> <em> <sup> <sub> <br>等
3.2 轉(zhuǎn)義
??Markdown 使用了很多特殊符號(hào)來表示特定的意義，如果需要顯示特定的符號(hào)則需要使用轉(zhuǎn)義字符，Markdown 使用反斜杠\轉(zhuǎn)義特殊字符：
??Markdown 支持以下這些符號(hào)前面加上反斜杠來幫助插入普通的符號(hào)：
\ 反斜線
` 反引號(hào)
* 星號(hào)
_ 下劃線
{} 花括號(hào)
[] 方括號(hào)
() 小括號(hào)
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 感嘆號(hào)
3.3 markdown首行縮進(jìn)
A 問題來源
??將Typora中編寫的md文件導(dǎo)入到簡書中時(shí)，文檔首行不縮進(jìn)。
B 解決方法
（不要忘記后面的分號(hào)）
半方大的空白：  ?或  
全方大的空白：   或  
不斷行的空白格： 或  
3.4 字體樣式與顏色
A 問題來源
??看到縮進(jìn)，就想到字體和顏色問題
B 解決方法
??使用HTML的方法。
1） 字體設(shè)置
? 關(guān)鍵詞為face
<font face = "黑體">我是黑體</font>
<font face = "宋體">我是宋體</font>
引號(hào)中可填：宋體、黑體、仿宋、微軟雅黑、華文彩云……
2） 大小設(shè)置
? 關(guān)鍵詞為size
<font size = 3>我的大小是3</font>
<font size = 4>我的大小是4</font>
3） 顏色設(shè)置
? 關(guān)鍵詞為color
<font color = red>我是紅色的</font>
<font color = purple>我是紫色的</font>
可以填寫數(shù)字，也可以填寫顏色的單詞。
3.5 Typora導(dǎo)出PDF文件時(shí)不全
A 問題來源
??利用Typora導(dǎo)出pdf文件時(shí)，有時(shí)出現(xiàn)無法導(dǎo)出的問題
B 解決方法
??當(dāng)typora導(dǎo)出PDF或HTML時(shí)碰到非代碼塊中的一對(duì)尖括號(hào)便會(huì)停止。因此需要把非代碼塊部分的一對(duì)尖括號(hào)去掉。
??代碼塊是什么：
這是代碼塊
???非代碼塊容易被忽略的有：兩個(gè)反引號(hào)中的，像這樣這樣的
??尖括號(hào)是什么：
這是一對(duì)尖括號(hào)：< >
參考資料
[1] 菜鳥教程RUNOOB.COM. Markdown教程. RUNOOB.COM. 2020. https://www.runoob.com/markdown/md-title.html
[2] 酒石酸菌. Typora編輯器——書寫即為美學(xué). 嗶哩嗶哩. 2018. https://www.bilibili.com/video/av20190823/?spm_id_from=333.788.videocard.0
[3] 寸草心2130. markdown實(shí)現(xiàn)首行縮進(jìn)、空格的兩種方法. CSDN博客. 2019. https://blog.csdn.net/qq_35531549/article/details/90292957
[4] Vinson.【經(jīng)驗(yàn)總結(jié)-markdown】markdown字體和顏色設(shè)置. 博客園cnblogs. 2019. https://www.cnblogs.com/vinnson/p/10845137.html
[5] 孤木不成林. typora導(dǎo)出pdf或HTML不全的解決辦法. CSDN博客. 2018. https://blog.csdn.net/ychhh/article/details/84790905
