歷史
Markdown是一種輕量級標記語言,創始人為約翰·格魯伯(英語:John Gruber)。它允許人們“使用易讀易寫的純文本格式編寫文檔,然后轉換成有效的XHTML(或者HTML)文檔”,
自從GitHub流行以來,Markdown作為一種輕量級標記語言就深受程序員的喜愛,上手也是非常簡單,接下來我們就來分析一下為什么markdown為什么能被一向挑剔的程序員們愛不釋手呢?
語法
(注:Markdown發展至今衍生出一些細節上有些許差異的版本,這里以GitHub 的Flavored Markdown(同樣在標准Markdown語法上有一些修改) 語法為標准討論,誰叫咱是程序員呢..)
head
Markdown支持多級標題對應不同的字體大小,例如:
# Markdown
## Markdown
### Markdown
#### Markdown
##### Markdown
###### Markdown
所對應的顯示內容為:
Markdown
Markdown
Markdown
Markdown
Markdown
Markdown
最多可以支持6個,而且需要注意的是,這里的#開頭的文字或標題必須另起一行,#和文字中間必須有空格,不然GitHub的README無法識別。
同時,有些愛思考的同學就會說,要是我用七個#,會不會將前六個#作為字體符號,最后一個在文本中顯示呢。例如:
####### Markdown
而結果是:
####### Markdown
顯然,Markdown並沒有對其進行轉化。
除了用#標識字體(標題)大小,還有一種方法:
Markdown
=========
Markdown
---------
所對應的顯示內容為:
Markdown
Markdown
這里的字體只分為兩級,大號的字體下一行用"="號隔開,略小一號的字體用"-"(短橫線)隔開,"="或"-"的數量最好是三個以上,但是有些版本可以為一個,通常的習慣為與字體等長。
2、段落和換行
分隔線
在實際的文本顯示中,為了使文本更加清晰明了,可以適當地加入一些分隔線
***
---
分隔線由***或者---表示,一般是三個連續的符號,單行開頭,也可以多於三個
換行
換行可以使用一個或者多個空行來另起一個段落,注意是一個空行,而不是簡單地用回車來另換一行,示例:
第一行
第二行
第三行
所對應的顯示內容為:
第一行
第二行第三行
很明顯,第二行和第三行連到了一起,那如果我就是不喜歡隔一個空行,非要以回車來換行呢,考慮到部分強迫症晚期患者,Markdown有另一種換行的方法:
在上一行的行尾添加兩個空格,然后以回車來換行,建議用空行換行
插入文本引用
如果我需要將一段文本與正文文本相區分,比如示例,引用文章之類的,怎么做呢?
答案是先換行(隔一個或者多個空行),然后新行以tab鍵開頭,鍵入文本,示例:
正文
引用文本示例
所對應的顯示內容為:
正文
引用文本示例。
列表
無序列表
無序列表k而已使用* + -來標識,注意在字符之后要添加一個空格,示例:
* Markdown1
+ Markdown2
- Markdown3
所對應的顯示內容為:
- Markdown1
- Markdown2
- Markdown3
結果顯示,這三種符號是可以交叉使用的
有序列表
有序列表需要添加一個相應的'數字'+'.'+'空格'來標識,示例:
1. Markdown1
2. Markdown2
3. Markdown3
所對應的顯示內容為:
- Markdown1
- Markdown2
- Markdown3
代碼
如何把代碼貼上去呢?很簡單,將代碼用兩個`包含起來,這個符號不是單引號,而是反引號,鍵盤左上角那個
`print "hello world" `
所對應的顯示內容為
print "hello world"
同時也可以用上面提到的引用文本的方法來貼代碼
鏈接
添加鏈接的方法為:
[博客](https://www.cnblogs.com/downey-blog/)
所對應的顯示內容為:
,點擊高亮字體即可進入相應鏈接
設置跳轉
在寫文檔時,經常會需要在某段文本上設置鏈接,跳轉到另一段文本中,最常見的是注腳,對於這些注腳,並不方便寫在正文中,但是寫在文檔末尾又沒頭沒尾的,我們就可以設置一個連接跳轉。它的語法是這樣的:
在需要跳轉的文本處添加:
[跳轉到末尾](#jump1)
在跳轉目的地添加:
<span id="jump1">測試跳轉的文本</span>
所對應的效果為:跳轉到末尾
注意[]中包含顯示的說明文本,而(#jump1)相當於定義一個匹配對象。
在跳轉目的地則是XXX的格式,jump1對應上述的匹配對象,而XXX是需要添加的文本。
插入圖片
插入圖片的方法與插入鏈接相比僅僅在前面多了一個 "!",即:

所對應的顯示內容為:
值得注意的是,目前還並沒有一種兼容性比較好的方法將圖片內嵌到文本中,一般的做法是在文本內引用圖片的鏈接,但是在這種做法下,如果圖片資源一旦遷移,將會額外增加修改成本
修改圖片大小
如果要修改圖片大小,可以使用HTML的處理方式來插入圖片,並設置固定大小
<img src="https://raw.githubusercontent.com/linux-downey/bloc_test/master/picture/Makedown/Makedown.png" width=100 height=60 />
所對應的顯示內容為:
同時,也可以按照比例來設置圖片大小
<img src="https://raw.githubusercontent.com/linux-downey/bloc_test/master/picture/Makedown/Makedown.png" width="%50" height="%50" />
所對應的顯示內容為:
測試跳轉的文本
好了,關於markdown的基本語法和使用介紹就到此為止啦,如果朋友們對於這個有什么疑問或者發現有文章中有什么錯誤,歡迎留言
原創博客,轉載請注明出處!
祝各位早日實現項目叢中過,bug不沾身.
(完)