對markdown的簡單語法理解
這也是我第一次用markdown語法寫的文章,還是有很多不足
【前提概要】
對于一個markdown小白來總結這篇文章,我理解的最深刻的就是,HTML與markdown語法之間的聯系。簡而言之,HTML不能使用markdown的語法,但是markdown中支持在HTML中的語法使用。所有我一開始用的HTML語法來寫的github的README.md文檔達到了我想要的效果 ,比如< p>或者< img>標簽,也可以用來作為markdown中的行段落和插入圖片。
【段落和換行】
要寫一篇文章的話,對于段落感跟換行是必須的,可以用HTML中的< br>標簽進行換行, 但在markdown中,也可以用兩個或兩個以上的空格加回車鍵,就可以換好行了。
【標題】
Markdown 支持兩種標題的語法,類 Setext 和類 atx 形式。
類 Setext 形式是用底線的形式,利用 = (最高階標題)和 - (第二階標題)。
相比于類Setext形式,我更喜歡用類atx形式,相比也比較簡單,直接在標題前面加上#即可,幾號標題加幾個#即可(1到6個)。
【區塊引用 Blockquotes】
在文字開頭添加“>”表示區塊引用(塊注釋)
【斜體和粗體】
在需要斜體的文字兩端用"*"或者"_"夾起來,而如要粗體,則用兩個"*"或者"_"夾起來。
【無序與有序列表】
在文字開頭添加(*, +, and -)實現無序列表。但是要注意在(*, +, and -)和文字之間需要添加空格。(一個文檔中最好只是用一種無序列表的表示方式),而有序列表在使用數字后面加上句號和空格即可。
【鏈接】
實現鏈接一共有兩種基本方式:內聯和引用方式。
內聯:在鏈接的文字外加上[],而在[]外加上(里面是鏈接的地址),如:這篇文章主要來自markdown語法。
引用:這篇文章主要來自[markdown語法][1],[第二個][2]
[1]: http://www.appinn.com/markdown/ "markdown"
[2]: http://www.appinn.com/markdown/ "markdown"
其中"markdown"表示鼠標移到鏈接的文字上去,會顯示出來的內容,如:
引用:這篇文章主要來自[markdown語法][1],[第二個][2]
[1]: http://www.appinn.com/markdown/ "markdown"
[2]: http://www.appinn.com/markdown/ "markdown"
【插入圖片】
插入圖片的方式跟鏈接的方式類似。
內聯方式:
引用方式:
![alt text][id]
[id]: /path/to/img.jpg "Title"
【代碼框】
有兩種方式,第一種是在一些比較簡單的代碼中,可以直接使用` < blockquote > `來實現。第二種是大片文字需要實現代碼框。使用Tab或四個空格。
【腳注】
hello[^hello]
[^hello]: hi
效果為:
hello[1]
【下劃線】
在空白行下方添加三條“-”橫線。
-
hi ?