近段時間來,一直在Jupyter-Notebook上利用Markdown記錄筆記,越發覺得Markdown之簡便強大,故做此博客,記錄下Markdown的一些語法,以備查閱複習之用。
- 此篇文章參考 Learning-Markdown一文,同時結合自己的學習使用經驗寫成。
- CSDN的博客系統的支持語法就是Markdown,用Markdown來寫Markdown,怎麼感覺有點怪怪的?
關於Markdown
簡介
Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文本格式編寫文檔,然後轉換成方便交流使用的 HTML (或者 XHTML)文檔。
優點
- 基於純文本,方便修改和共享
- 幾乎可以在所有的文本編輯器中編寫
- 有衆多編程語言的實現,以及應用的擴展
- 在 CSDN、Github等網站有很好的應用
- 易轉換爲HTML文檔或其他格式
- 兼容HTML語法,使得功能更爲強大
場景
適合用來編寫文檔、記錄筆記、撰寫文章等文字記錄工作
Markdown語法
轉義符
- 爲什麼我把轉義符放在第一位呢?因爲下面這些都要加轉義符啊。。。(用Markdown寫Markdown,越想越彆扭)
- 同許多語法一樣,轉義符用反斜槓 \ 表示,可以表示字符原來的含義(媽媽再也不用擔心我瞎操作了( • ̀ω•́ )✧)
目錄
語法: @[toc]
標題
一級標題: #
二級標題:##
以此類推
字體
加粗
- 語法:**字**
效果:字 - 語法:_字_
效果:字 - 語法:<b>字</b>
效果:字 - 語法:<strong>字</stong>
效果:字
傾斜
- 語法: *字*
效果:字 - 語法:<em>字</em>
效果:字
刪除線
語法:~~體~~
效果: 體
其他設置(大小,顏色,字體等)
Markdown 語法對於字體的設定只有如上這些,要想修改字體的其他屬性,如大小,字體格式,顏色等,可使用兼容的 HTML 語法。
語法: <font color=“blue” size=3 face=“華文行楷”>無問西東</font>
效果: 無問西東
段落
- 新的段落的前後必須是空行
- 如果需要在段落內換行,可以加入換行符<br>
語法:如果需要在<br>段落內換行,可以加入換行符
效果:如果需要在
段落內換行,可以加入換行符 - 在段落內換行也可在行末尾敲擊兩下空格,再使用Enter回車鍵換行
- 大部分情況下可使用Enter回車鍵換行
分割線
- 在一行內輸入三個或更多相同字符(*,-,_任選一種),並且用空格隔開,且一行內不能有其他字符:
語法:
* * *
效果:
- 使用 HTML 語法 <hr>標籤
語法:<hr>
效果:
列表
有序列表
語法:
\1. 無
\2. 問
\3. 西
\4. 東
效果:
- 無
- 問
- 西
- 東
無序列表
語法:
* 愛你所愛
* 行你所行
效果:
- 愛你所愛
- 行你所行
列表嵌套
列表中可以嵌套列表,有序列表不必侷限於序列,如下圖所示:
- 愛你所愛
- 行你所行
- 聽從你心
- 無問西東
代碼
代碼使用的符號爲 Tab 鍵上方的鍵的英文輸出符號
行代碼
語法:`print(“Hello world!”)`
效果:print("Hello world!")
代碼塊
語法:
```
a = 1
b = 2
print(a+b)
```
效果:
a = 1
b = 2
print(a+b)
代碼高亮
**Markdown支持代碼高亮,只需在代碼塊的第一個符號後加上相應的語言名稱即可
語法:
```py
a = 1
b = 2
print(a+b)
```
或者
```python
a = 1
b = 2
print(a+b)
```
效果:
a = 1
b = 2
print(a+b)
a = 1
b = 2
print(a+b)
超鏈接
自動鏈接
使用 <> 包括的URL或郵箱地址會被自動轉化爲超鏈接
本地鏈接
語法:[Link text](…/Google.html)
效果:Google
提醒:.在路徑中表示返回上一級,.的數量代表着返回的級數
網絡鏈接
語法:[Link text](URL)
效果:CSDN
圖片
本地鏈接
同超鏈接的本地鏈接差不多,只不過在語句最前面加上一個治感冒的感嘆號
語法格式:![圖片命名](相對路徑)
網絡鏈接
同超鏈接的網絡鏈接差不多,只不過在語句最前面加上一個感嘆號
語法:![圖片命名](URL)
效果:
表格
單元格和表頭
- 使用 | 來分隔不同的單元格,用 - 分割表頭和其他行
- 爲了美觀,一般在左右兩側都是用 | 來標記單元格邊界
- 爲了看起來更爲清晰,| 和 - 兩側需要至少有一個空格
對齊
- :— 代表左對齊
- :–: 代表居中對齊
- —:代表右對齊
更多
表格的更多操作可使用 HTML 的表格操作方法
引用
單行引用
語法:
>這裏是引用
效果:
這裏是引用
多行引用
可在每行前都加上引用符號>
嵌套引用
一層引用中可以嵌套下一層引用
語法:
>一層引用
>>二層引用
>>>三層引用
效果:
一層引用
二層引用
三層引用
數學符號及公式
- 絕大部分的 Markdown 編輯器都支持使用 Latex 語法進行數學符號及公式的編輯,通過 Mathjax 插件實現,基本上默認存在,無需手動安裝。
- 因爲使用 Latex 語法實現數學符號及公式的編輯,因此其使用同 Latex 的語法一致。同時,受限於環境,Markdown僅提供最基本的數學符號及公式的編輯,Latex的其他功能並沒有包含於其中。
- 因爲網上資源較多,所以我選擇了一篇較爲不錯的入門介紹供大家參考:Markdown數學公式語法
- 關於 Latex 的更多符號可參考:
Latex常用特殊符號對應表
數學專題之希臘字符的插入
待辦事項
語法:
* [ ] C
- [ ] C++
- [X] Java
* [x] Python
效果:
- C
- C++
- Java
-
Python
-
*和\均可
-
x可選,也可在生成頁面自行帶上對號
-
可向列表一樣進行嵌套
Markdown格式轉換
依照所使用的環境不同,方法亦有所不同,這裏以CSDN的博客系統爲例
導入
導出
- 如果想轉化爲PDF格式,可以先保存爲HTML格式,然後通過網頁打印功能實現
- 如果想轉化爲WORD格式,可以先保存爲HTML格式,複製粘貼即可
編輯器與擴展
這一方面可參考上述提到的參考源: Learning-Markdown