
前言
最近在重新學習Markdown文法,打算用在筆記和部落格中。在網上找到了一篇很不錯的英文Markdown入門教程,從标題、強調到代碼高亮和圖檔超連結等方方面面的常用文法都覆寫到了。現在将它整理成中文分享出來,文後提供了原教程連結。
一、标題
一級标題
# 一級标題
二級标題
## 二級标題
三級标題 ### 三級标題
單行分割線二級标題
單行分割線二級标題
---
雙行分割線一級标題
雙行分割線一級标題
===
二、強調
知乎編輯器不支援md樣式的删除線,是以在此使用了圖檔,源代碼:~~删除線~~
斜體 或 斜體:
_斜體_ 或 *斜體*
加粗 或
加粗:
__加粗__ 或 **加粗**
三、清單
- 對于如下這個Markdown清單樣式:
知乎不支援子清單的縮進,圖為Typora編輯器中的清單實際渲染效果
- 其源代碼如下:
1. 有序清單
2. 另一行有序清單
- 另一行子清單 (減号)
* 無序号子清單 (星号)
+ 第三種子清單的寫法 (加号)
四、連結
1. 内聯超連結:
- 方括号裡是超連結文字 [文字] ,緊跟着的圓括号裡是URL (URL)
- 這是一個内聯超連結
- 源代碼:
[這是一個内聯超連結](http://www.google.com)
2. 引用超連結
2.1. 前一對方括号内是文字顯示内容,後一對方括号表示引用的URL,例如
[文字][URL]。同時在段落底部建立綁定
[URL]: xxx,名字要與第二對方括号裡的内容相同
- 這是一個[文字][URL]式的引用超連結
- 源代碼:
[這是一個[文字][URL]式的引用超連結][URL_2]
[URL_2]: http://www.google.com
2.2. 用數字标号同樣可以綁定URL,例如
[1]: xxx- 這是一個用數字标号綁定URL的超連結
- 源代碼:
[這是一個用數字标号綁定URL的超連結][1]
[1]: http://www.qq.com
2.3. 可以隻用一對方括号,展示URL文字内容
[文字],在段落底用相同的内容綁定URL
[文字]: xxx- 這是一個隻用到一對方括号的超連結
- 源代碼:
[這是一個隻用到一對方括号的超連結]
[這是一個隻用到一對方括号的超連結]: http://www.zhihu.com
3. 插入超連結最簡單的方式
- 尖括号裡的URL可以直接轉換成超連結 :http://www.wikipedia.org
- 源代碼:
<http://www.wikipedia.org>
五、圖檔
1. 内聯樣式
- 格式:
- 各參數含義: alt_text:圖檔無法被加載時作為備選項顯示的文字 address:圖床中的圖檔位址, title_str:滑鼠懸浮時的顯示的圖檔标題文字字元串,用雙引号包圍,與位址之間用空格隔開
- 例如在Markdown中插入這樣一幅圖檔:
- 其對應的源代碼為 :

可以将滑鼠懸浮在圖檔上,看到提示文字的确為“這是圖檔标題”。
2. 引用樣式
- 格式:![alt_text][logo] 其中logo是在段落底部建立的與圖檔位址及标題的綁定: [logo]: address title_str
- 用引用樣式來插入與内聯一例中相同的圖檔:
- 其對應的源代碼為:
![無法加載圖檔][pic]
[pic]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "這是圖檔标題"
六、代碼塊
1. 代碼高亮
- 用重音符 ` 這個符号來包圍想要高亮顯示的代碼塊:
bar, foo
- 源代碼為:
`bar, foo`
2. 插入多行代碼塊
- 用三個連續的重音符
來引入接下來的一行或多行代碼塊,并同樣使用```
來表示代碼塊到此為止。可以在第一行中給出代碼使用的具體語言。例如:```
# 這是在markdown中插入的python代碼塊
for i in range(10)
print i
- 對應的源代碼為:
```python
# 這是在markdown中插入的python代碼塊
for i in range(10)
print i
```
七、表格
1. 行列的分隔符
- 用一個管道符号
用于分割列;用一個或多個短劃線|
用于分割行。例如:-
Markdown | Less |Pretty
- | - | -
*Still* | `renders` | **nicely**
1 | 2 | 3
- 在Markdown中被渲染成:
知乎不支援在編輯中插入表格,圖為Typora編輯器中的表格實際渲染效果
2. 單元格對齊方式
- 可以用冒号
在短劃線兩旁來辨別表格單元格的對齊方式。:
- 在短劃線右邊表明右對齊:
---:
- 在短劃線左邊表明右對齊:
:---
- 兩邊都有表示居中對齊:
:---:
- 在短劃線右邊表明右對齊:
- 例如:
知乎不支援在編輯中插入表格,圖為Typora編輯器中的表格實際渲染效果
- 對應的源代碼為:
| Markdown中 | 表格的表示方法 | 非常有趣:) |
| -----------|:-------------------:| ------------:|
| 第3列是 | 右對齊 | $1600 |
| 第2列是 | 居中對齊 | $12 |
| 短橫線可以 | 根據單元格内字元長短 | 任意增删 |
八、引用塊
1. 格式
- 用右尖括号
引入一段引文,markdown可以根據字元長短在渲染時恰當地處理換行。>
- 例如:
這是一段引文
這是新行中的一段引文,與上文同屬一個引用塊
盡管已經換了新行,隻要中間沒有被空行隔斷,渲染時它們會顯示為同一個引文塊
現在被隔斷了
這是一段非常長、極其長、長得不可思議的引文,這段引文的奧秘在于:盡管它又臭又長,但是在markdown視圖下依然會被正确地渲染并顯示,因為markdown可以根據字元數目自動換行,到這裡為止依然是同一行原文:)
- 源代碼如下:
> 這是一段引文
>
> 這是新行中的一段引文,與上文同屬一個引用塊
> 盡管已經換了新行,隻要中間沒有被空行隔斷,渲染時它們會顯示為同一個引文塊
> 現在被隔斷了
> 這是一段非常長、極其長、長得不可思議的引文,這段引文的奧秘在于:盡管它又臭又長,但是在markdown視圖下依然會被正确地渲染并顯示,因為markdown可以根據字元數目在渲染時自動換行,到這裡為止依然是同一段引文:)
參考連結
https://github.com/adam-p/markdown-here/wiki/Markdown-Here-Cheatsheetgithub.com