Markdown 學(xué)習(xí)筆記·入門
花一點(diǎn)點(diǎn)時(shí)間了解了下Markdown的語(yǔ)法,確實(shí)非常簡(jiǎn)單,這里做下總結(jié),也算是對(duì)Markdown語(yǔ)法的熟悉,及模仿造輪子吧~
markdown 簡(jiǎn)介
Markdown是一種可以使用普通文本編輯器編寫的標(biāo)記語(yǔ)言,通過(guò)簡(jiǎn)單的標(biāo)記語(yǔ)法,它可以使普通文本內(nèi)容具有一定的格式。
Markdown具有一系列衍生版本,用于擴(kuò)展Markdown的功能(如表格、腳注、內(nèi)嵌HTML等等),這些功能原初的Markdown尚不具備,它們能讓Markdown轉(zhuǎn)換成更多的格式,例如LaTeX,Docbook。Markdown增強(qiáng)版中比較有名的有Markdown Extra、MultiMarkdown、 Maruku等。這些衍生版本要么基于工具,如Pandoc;要么基于網(wǎng)站,如GitHub和Wikipedia,在語(yǔ)法上基本兼容,但在一些語(yǔ)法和渲染效果上有改動(dòng)。--百度百科
特點(diǎn)總結(jié)
- 純文本,所以兼容性極強(qiáng),可以用所有文本編輯器打開。
- 讓你專注于文字而不是排版。
- 格式轉(zhuǎn)換方便,Markdown 的文本你可以輕松轉(zhuǎn)換為 html、電子書等。
- Markdown 的標(biāo)記語(yǔ)法有極好的可讀性。
Markdown 語(yǔ)法介紹
基本符號(hào)
- *,-,+ 3個(gè)符號(hào) 被稱為Markdown符號(hào)
- 空白行表示另起一個(gè)段落
- `是表示inline代碼,tab是用來(lái)標(biāo)記 代碼段,分別對(duì)應(yīng)html的code,pre標(biāo)簽
標(biāo)題
-
#+ 空格 后面的文字即表示為標(biāo)題# 表示一級(jí)標(biāo)題,## 表示二級(jí)標(biāo)題,依次表示 1-6 級(jí)標(biāo)題 注意: 符號(hào)后面要加一個(gè) 空格 和文本內(nèi)容隔開
-
還可以在文字下行加= 表示大標(biāo)題 - 表示小標(biāo)題 慎用吧
例如: 大標(biāo)題 = 小標(biāo)題 -
字體:斜體 / 加粗
*文本* 表示文本內(nèi)容為斜體, **文本** 表示文本內(nèi)容為斜體
- 效果: 斜體文本 加粗文本
換行
- 段落間加一個(gè) 空白行 分割 同html中的
<p> - 連續(xù)兩個(gè)空格即為換行 同html中的
<br>
列表
使用*,+,-加上一個(gè)空格來(lái)表示
-
可以支持嵌套,如
*,+,-效果一樣的 - 外層列表項(xiàng)目 + 內(nèi)層列表項(xiàng)目 + 內(nèi)層無(wú)序列表項(xiàng)目 + 內(nèi)層列表項(xiàng)目 - 外層列表項(xiàng)目 效果
- 外層列表項(xiàng)目
- 內(nèi)層列表項(xiàng)目
- 內(nèi)層列表項(xiàng)目
- 內(nèi)層列表項(xiàng)目
- 外層列表項(xiàng)目
-
有序列表用 數(shù)字+英文點(diǎn)+空格來(lái)表示
- 1. 這樣會(huì)展示序號(hào) 效果:
- 這樣會(huì)展示序號(hào)
注意:列表內(nèi)容很長(zhǎng)的,不需要手工輸入換行符,css控制段落的寬度,會(huì)自動(dòng)的縮放的
鏈接
-
這其實(shí)是我第一個(gè)接觸的markdown語(yǔ)法,第一篇資料收集時(shí)就用到了
直接使用 [文本](鏈接) -
效果:百度
如果很多地方需要相同的url呢,可以預(yù)先定義url 這樣玩:[ref_name]:URL ref_name 一般使用數(shù)字表示,顯得專業(yè) 然后在需要使用鏈接的地方 使用[文本][ref_name] 這種方式即可,酷炫 -
效果
[1]:https://www.baidu.com/[ref_name]:url 如: [1]:https://www.baidu.com/ 引用上面定義的url [百度][1]
-
如果想把URL展示出來(lái),并可以作為鏈接使用 這樣玩:
<URL><url> 如: <https://www.baidu.com/>
圖片
-
圖片語(yǔ)法與鏈接類似
 如: 
-
同樣可以使用引用的方式使用圖片
這樣定義:[id]:圖片url 這樣引用定義 ![][id] 定義圖片的大小或比例
-
方法一:嵌入HTML代碼
<img src="./xxx.png" width = "300" height = "200" alt="圖片名稱" align=center /> 注意:要居中展示,外圍加<div>即可 -
方法二:使用支持圖片大小更改操作的 Mou 編輯器 (mac可以玩)
 注意: =前有個(gè)空格,可以只寫寬度。 方法三: 阿里云的OSS,七牛云的圖片服務(wù)器時(shí),url上加上相關(guān)操字段即可實(shí)現(xiàn)圖片大小,比例修改,具體見各自的產(chǎn)品文檔~
引用
- 開篇關(guān)于Markdown的簡(jiǎn)介和特點(diǎn)就是引用的百度, 只要在第一行加上 “>”和一個(gè)空格,表示代碼引用,還可以嵌套
轉(zhuǎn)義
-
使用 \ 來(lái)轉(zhuǎn)義,表示文本中的markdown符號(hào)
如: \[百度](https://www.baidu.com/) 效果:[百度](https://www.baidu.com/)
表格
- 表格代碼
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
------------- 左對(duì)齊 :-------------: 居中 -----:右對(duì)齊
- 效果:
| Tables | Are | Cool |
|---|---|---|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
代碼塊
- 按下Tab鍵 或4個(gè)空格即表示代碼塊
C#:
//這里顯示一些代碼,在正文顯示中會(huì)自動(dòng)識(shí)別語(yǔ)言,進(jìn)行代碼染色,這是一段C#代碼
public class Blog
{
public int Id { get; set; }
public string Subject { get; set; }
}
這樣基本就可以玩起來(lái)了,還是需要多實(shí)踐,多謝,多總結(jié)。
我們活在各自的的心靈世界,我們有什么樣的心,就決定我們看到什么樣的世界