[TOC]
出發(fā)點
前段時間為了學習新東西同欠,要把一些的學的新東西整理歸檔。曾經都是看別人是用MD的文件記錄,GitHub上面也很多都是使用MD文件忱反,但是自己偷懶一直沒時間。有次要歸檔自己寫的一個文檔滤愕。剛剛看是用World記錄發(fā)現(xiàn)實在是麻煩温算。很多代碼的引用效果亂七八糟,而且要貼到一些技術論文间影,排版也非常麻煩注竿。下定決心學習下Markdown。這回整理這篇文章也當練手學習下Markdown的語法。
Markdown綜述
Markdown 是一種輕量級的 “標記語言”巩割,創(chuàng)始人為約翰·格魯伯(John Gruber)裙顽。它允許人們“使用易讀易寫的純文本格式編寫文檔,然后轉換成有效的XHTML(或者HTML)文檔”宣谈。
——Wikipedia
Markdown 擁有這眾多的優(yōu)點
純文本編輯
學習成本低
-
廣泛在軟件支持
現(xiàn)在編寫文章的用的Typora
在碼農界有深厚的基礎
語法基礎
強調
代碼 | 效果 |
---|---|
*這是斜體* |
這是斜體 |
_這是斜體_ |
這是斜體 |
**這是粗體** |
這是粗體 |
__這是粗體__ |
這是粗體 |
標題
#這是一級標題
## 這是二級標題
### 這是三級標題
#### 這是四級標題
##### 這是五級標題
###### 這是六級標題
效果類似下面:
這是一級標題
這是二級標題
這是三級標題
這是四級標題
這是五級標題
這是六級標題
注意
- 最后
#
符號后面加空格 - 標題只有6級
引用
Markdown 中應用符號 >
符號實現(xiàn)愈犹。
在引用里面可以有換行符號存在,所以空格不會退出引用闻丑。要退出引用要一行空白符
> 這是引用
這里面是可以換行的
>>引用可以嵌套引用
>
> 另一行引用漩怎,前面需要一個視覺上的空行表示內層嵌套的結束,空行前面的('>')可以有可以沒有嗦嗡。
這是引用
這還是引用
這是嵌套引用
還是嵌套應用
多層嵌套
列表
有序列表
數(shù)字不能省略但可無序勋锤,點號之后的空格不能少。
雖然下面代碼的序號是 1侥祭,2叁执,4,但是在顯示時矮冬,仍然為自然數(shù)序列徒恋,并不是完成與編號一致。
同樣的欢伏,在列表的最后需要留有一行空行入挣,以表達列表的結束,不然將作為一個無編號的列表存在硝拧。
1. 列表A
2. 列表B
3. 列表C
效果:
- 列表A
- 列表B
- 列表C
無序列表
使用符號+-*
來實現(xiàn)径筏,符號后面的空格不能少。不能混合使用
代碼
+ 列表A
+ 列表B
- 列表C
- 列表D
* 列表E
* 列表F
效果
- 列表A
- 列表B
- 列表C
- 列表D
- 列表E
- 列表F
嵌套列表
代碼
- 一級列表A
- 一級列表B
- 二級列表A
- 二級列表B
* 三級列表D
* 三級列表F
- 二級列表C
- 一級列表C
效果
- 一級列表A
- 一級列表B
- 二級列表A
- 二級列表B
- 三級列表D
- 三級列表F
- 二級列表C
- 一級列表C
有序列表一樣的障陶, 也可以通過空格實現(xiàn)
分割線
三個或者更多的-_*
符號來實現(xiàn)滋恬,必須單獨一行,符號中間可含空格抱究。
代碼
---
-- --
-- -
-------
*******
** **
***
效果
超鏈接
圖片與鏈接恢氯,在 Markdown 語法中表達類似,都是 [鏈接文字](鏈接地址)
這樣的形式鼓寺。
普通鏈接
代碼
[Wikipedia Markdown 條目](https://zh.wikipedia.org/wiki/Markdown)
[Wikipedia Markdown 條目](https://zh.wikipedia.org/wiki/Markdown "Markdown 條目")
效果
Wikipedia Markdown 條目
Wikipedia Markdown 條目
圖片鏈接
圖片需要在[]
前面加一個!
以使圖片在再網頁上面顯示勋拟,而不僅僅是鏈接
代碼
![百度的logo](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1562343025032&di=0bcad55f2b2c0e7ba6a1b898c0769537&imgtype=0&src=http%3A%2F%2Fimgup04.iefans.net%2Fiefans%2F2019-02%2F11%2F11%2F15498570716693_1.jpg)
效果
表格
對于表格的支持,要根據(jù)具體的 Markdown 解釋器來判定妈候。在 hexo 中敢靡,支持以下 Markdown 形式的表格。
需要注意以下幾點:
- 表格第一行為標題苦银,樣式會被特殊處理
-
|
前后要留有空格 - 只要是三個
-
字符表示分隔線 - 通過
:
來區(qū)分啸胧,左對齊赶站、居中、右對齊
代碼
| 1 | 2 | 3 |
| --- |:---:| ---:|
| aaa | bbbbbb | c |
| aaaaaa | b | ccc |
效果如下:
1 | 2 | 3 |
---|---|---|
aaa | bbbbbb | c |
aaaaaa | b | ccc |
代碼
行內代碼
代碼:
這是一行內代代碼纺念,`using namespace UnityEngine;`
效果:
這是一行內代代碼贝椿,using namespace UnityEngine;
區(qū)塊代碼
如果要成塊的引用代碼,有兩種方法陷谱,一種是用制表符縮進烙博,另一種,則是用三個反引號 **叭首,將代碼塊包起來习勤。 在三個反引號后踪栋,加上語言說明焙格,例如 **
C# 這樣,便指定了之后的代碼采用 java 的高亮夷都。
using namespace UnityEngine;
public class Application : Monobehavior{
public void Awake(){
//TODO:
}
public void Star(){
}
}
公式
還不會用眷唉。。囤官。冬阳。
后續(xù)有時間把舊的文章全部用 Markdown重新寫一遍。