Markdown语法入门
更新記錄
| 1.0 | 2018-4-5 | 完善了“表格”這一節 |
| 1.1 | 2022-2-6 | 完善了“鏈接”這一節 |
寫在前面: 若沒有特別說明,則以CSDN在線編輯器為例,不同的編輯器或平臺也許效果不一樣。
關于Markdown語法的文章是汗牛充棟,一搜一大片。這里我不打算寫一篇大而全的文章,而是提綱挈領,讓新手快速入門。
Markdown 是什么
Markdown 是一種輕量級標記語言,創始人為約翰·格魯伯(John Gruber)。它允許人們使用易讀易寫的純文本格式編寫文檔,然后轉換成有效的 XHTML(或者 HTML)文檔。這種語言吸收了很多在電子郵件中已有的純文本標記的特性。
基本語法
標題
一個到多個#,然后空格,最后是文字。
# 標題H1 ## 標題H2 ### 標題H3 #### 標題H4 ##### 標題H5 ###### 標題H6以上文本轉換后如下:
列表
無序列表
提示符(*或者-或者+),然后是空格,最后是文字。敲擊回車的時候,會自動出現新提示符。想要結束列表,連續敲兩下回車即可。
`
- A
- B
- C
`
以上文本轉換后得到:
有序列表
先是數字,然后是.,再然后是空格,最后是文字。敲擊回車的時候,會自動出現新序號。想要結束列表,連續敲兩下回車即可。
`
`
以上文本轉換后得到:
代碼
代碼塊
先敲Tab鍵,然后寫代碼。連續敲兩個回車則結束代碼塊。注意:代碼塊開始前需要有一個空行。
int a = 100; ++a;行內代碼
可以通過兩個反引號(Tab 鍵上方、數字 1 左側的那個按鍵)插入行內代碼。
`int a = 100;`
轉換后是:
int a = 100;
分隔線
在一行中使用三個或更多的-或者*或者_ ,然后換行。
---(回車)
效果如下:
強調
斜體
用兩個*把要強調的內容包含起來,則表現為斜體。
*我是斜體*
效果如下:
我是斜體
粗體
用兩個**把要強調的內容包含起來,則表現為粗體。
**我是粗體**
效果如下:
我是粗體
引用
單行引用
在行首使用 >符號,就可以將其后的內容標記為引用。
>春風得意馬蹄疾,一日看盡長安花
效果如下:
春風得意馬蹄疾,一日看盡長安花
多行引用
如果僅在第一行使用 >, 后面相鄰的行即使省略 >,也會變成引用內容。
>在天愿作比翼鳥,在地愿為連理枝。 天長地久有時盡,此恨綿綿無絕期。
以上文本被轉換為:
在天愿作比翼鳥,在地愿為連理枝。
天長地久有時盡,此恨綿綿無絕期。
要結束引用,在引用的末尾連續敲兩個回車即可。
嵌套的引用
用多個>就可以表示嵌套的引用。
>子曰
>>學而時習之,不亦說乎?有朋自遠方來,不亦樂乎?
效果如下:
子曰
學而時習之,不亦說乎?有朋自遠方來,不亦樂乎?
引用中可以使用其他語法
引用的內容也可以使用其他語法,比如標題、列表、強調等。
>1. 我是列表 >2. 我是列表 >3. 我是列表 > >*我是斜體* >**我是粗體** > > int a = 0; > int b = 1; > int c = a + b;效果如下:
我是斜體
我是粗體
超鏈接
行內式
格式為:
[鏈接文字](地址 '標題')
注:地址與標題之間有一個空格。
例如:
[百度首頁](https://www.baidu.com/ "跳轉到百度首頁")
效果如下:
百度首頁
當你把鼠標停留在鏈接名稱上,則會顯示出標題。如下圖:
注:在不需要的情況下,標題可以省略。
參考式
參考式超鏈接一般用在學術論文上,或者某個鏈接在文章中多處被引用的情況,這樣便于對鏈接統一管理。
參考式鏈接的寫法相當于把行內式拆分成兩部分,并通過一個鏈接標記來連接兩部分。
語法說明:
參考式鏈接分為兩部分:首先寫
[鏈接文字][鏈接標記]
然后在文本的任意位置寫
[鏈接標記]:地址 "標題"
例如:
我經常去的幾個網站是[GitHub][1],[知乎][2],[簡書][3]。
[1]:https://github.com "github.com"
[2]:https://www.zhihu.com "zhihu.com"
[3]:http://www.jianshu.com "jianshu.com"
效果:
我經常去的幾個網站是GitHub,知乎,簡書。
如果鏈接文字本身可以作鏈接標記,你也可以把上面兩行分別寫為:
[鏈接文字][]
[鏈接文字]:地址 "標題"
例如:
我經常去的幾個網站是[GitHub][],[知乎][],[簡書][]。
[GitHub]:https://github.com "github.com"
[知乎]:https://www.zhihu.com "zhihu.com"
[簡書]:http://www.jianshu.com "jianshu.com"
效果:
我經常去的幾個網站是GitHub,知乎,簡書。
圖片
插入圖片的語法和插入超鏈接的語法基本一致,只是在最前面多一個!。也分為行內式和參考式兩種。
行內式: 
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img-zO4IevEw-1644135834525)(https://img-blog.csdn.net/20180221110404166 “行內式——你看我萌嗎”)]
參考式1:
![猴子][4]
[4]:https://img-blog.csdn.net/20180221110404166 "參考式1——你看我萌嗎"
參考式2(把鏈接文字本身作為鏈接標記):
![猴子][]
[猴子]:https://img-blog.csdn.net/20180221110404166 "參考式2——你看我萌嗎"
轉義字符
Markdown可以利用反斜線\來插入一些在語法中有其它意義的符號。
例如:想把星號加在文字兩側(但不是斜體),你可以在星號的前面加上反斜線:
\*literal asterisks\*
效果:
*literal asterisks*
Markdown 支持在下面這些符號前面加上反斜線來插入普通的符號:
\ 反斜線
` 反引號
- 星號
_ 下劃線
{} 大括號
[] 方括號
() 括號
# 井號
- 加號
- 減號
. 英文句點
! 感嘆號
擴展語法
刪除線
用兩個~~把文字包起來。
~~我是刪除線~~效果:
我是刪除線
代碼塊和語法高亮
與原來使用縮進來添加代碼塊的語法不同,這里使用一對三個反引號
來包含多行代碼:
效果: ``` int a = 0; a++; ``` 在上面的語法基礎上,在第一個**三個反引號** 之后添加代碼的語言名稱,即可實現語法高亮。
```cint a = 0;a++; ```
效果: ```c int a = 0; a++; ```
表格
基本格式
使用| 來分隔不同的單元格,使用-來分隔表頭和其他行。
name | age
---- | ---
Leslie| 12
Mike | 32
效果:
| Leslie | 12 |
| Mike | 32 |
指定對齊方式
在表頭下方的分隔線----標記中加入:,即可指定對齊方式。
:---代表左對齊;
:---: 代表居中對齊;
---:代表右對齊。
效果(以MarkdownPad編輯器為例):
如果不使用對齊標記,單元格中的內容默認左對齊,表頭單元格中的內容默認居中對齊(MarkdownPad就是這樣,不同的實現可能會有不同的效果)。
表格內換行
可以用<br>表示換行。
Name | Lucky Number ---- | --- Leslie| 2<br>7 Mike | 3<br>5<br>8效果:
| Leslie | 2 7 |
| Mike | 3 5 8 |
表格內嵌套
同引用一樣,表格的內容也可以使用其他語法,比如公式、引用、行內代碼等。
Name | *abcdef* ---- |----- Leslie| `int a=18;` Mike | $\log_28$ Ann| >青霄有路終須到,金榜無名誓不歸效果:
| Leslie | int a=18; |
| Mike | log?28\log_28log2?8 |
| Ann | >青霄有路終須到,金榜無名誓不歸 |
內嵌HTML
下劃線
Markdown 并無下劃線的原生語法,因為會和鏈接的默認樣式產生混淆。如果你非要給文字加個下劃線,也有辦法。
用<u>和</u>把文字括起來,則有下劃線效果。
<u>我有下劃線,可是我不是鏈接</u>
效果:
我有下劃線,可是我不是鏈接
字體、字號、顏色
例1:指定字體
<font face="隸書"> 我是隸書 </font>
效果:
我是隸書
例2:指定字號
size的取值范圍:從 1 到 7 ,瀏覽器默認值是 3。
<font size=5 > 我的size = 5 </font>
效果:
我的size = 5
例3:指定顏色
<font color=GreenYellow> 我的color=GreenYellow </font>
效果:
我的color=GreenYellow
關于更多的顏色,可以參考我的博文
Markdown編輯器攻略——字體,字號,顏色
背景色
Markdown本身不支持背景色設置,需要采用內置html的方式實現。借助 table,tr, td 等表格標簽的 bgcolor 屬性來實現背景色功能。
舉例1:
<table><tr><td bgcolor=orange> 背景色是橙色 </td></tr></table>
效果:
| 背景色是橙色 |
| Hello World |
| Hello World |
【完】
參考資料
http://xianbai.me/learn-md/article/syntax/horizontal-rule.html
http://blog.csdn.net/u010177286/article/details/50358720
總結
以上是生活随笔為你收集整理的Markdown语法入门的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 编写程序,删除数组中重复的元素,并统计各
- 下一篇: 消息长度_【消息】听说咱安阳的第一条封闭