Markdown 基礎語法

Markdown語法總結

一.標題

1. 兩個= 或者兩個- 對應1、2階標題
This is an H1(=最高階標題)
==
This is an H2(-第二階標題)
--

對應效果:

This is an H1(=最高階標題)
==
This is an H2(-第二階標題)
--

2.在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階
# 這是 H1
## 這是 H2
###### 這是 H6

對應效果

這是 H1

這是 H2

這是 H6


二.區塊引用 Blockquotes

1.每行話前都加>

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

對應的效果如下:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

2.整個段落的第一句話前加>

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus aqipiscing.

對應的效果如下:

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus aqipiscing.

3.區塊引用可以嵌套(例如:引用內的引用),只要根據層次加上不同數量的,注意中間加個>分割。
> This is the first level of quoting.
>
> > This is nested block quote.
>>>遞減時中間加個>,如果不加的話,會一直保持最后的縮進
> 
>>This is nested block quote.
> Back to the first level.

This is the first level of quoting.

This is nested block quote.

遞減時中間加個">",如果不加的話,會一直保持最后的縮進

This is nested block quote.
Back to the first level.

4.引用的區塊內也可以使用其他的 Markdown 語法,包括標題、列表、代碼區塊等:
> ## 這是一個標題。
> 1.  這是第一行列表項。
> 2.  這是第二行列表項。

> 給出一些例子代碼:
> 
>    return shell_exec("echo $input | $markdown_script");  (最前邊要有4個空格)

對應效果:

這是一個標題。

  1. 這是第一行列表項。
  2. 這是第二行列表項。

給出一些例子代碼:

return shell_exec("echo $input | $markdown_script");


三.列表

Markdown 支持有序列表和無序列表。

1.無序列表使用星號、加號或是減號作為列表標記:
* Red    
- Green
+ Blue
  • Red
  • Green
  • Blue
2.有序列表則使用數字接著一個英文句點:
1. Bird   
2. McHale
3. Parish
  1. Bird
  2. McHale
  3. Parish

你可以完全不用在意數字的正確性,建議第一個項目最好還是從 1. 開始。

四.代碼區塊

1.使用 <pre> 和 <code> 標簽來把代碼區塊包起來。
<pre> 代碼塊 </pre>
<code>單行代碼</code>  

效果如下,簡書不支持這種語法:
<pre> 代碼塊格式 </pre>
<code>單行代碼格式</code>

2.使用反引號“`”包單行代碼
`單行代碼格式`  

單行代碼格式

3.代碼區使用反引號"`"的方式就是用"``"將"`"包起來。
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``

轉換成的效果如下:

A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`

4.使用三個反引號"```"包代碼塊,且前后的3個反引號各占一行。
```
代碼塊
```

效果如下

代碼塊
5.也可以只要簡單地縮進 4 個空格或是 1 個制表符就可以。
    這是一個代碼區塊。

Markdown 轉換成如下效果:

這是一個代碼區塊。

且每行一階的縮進(4 個空格或是 1 個制表符),都會被移除。一個代碼區塊會一直持續到沒有縮進的那一行(或是文件結尾)。

6.代碼塊內特殊字符不會起作用。

代碼區塊中,一般的 Markdown 語法不會被轉換,像是星號便只是星號,這表示你可以很容易地以 Markdown 語法撰寫 Markdown 語法相關的文件。


五.分割線

你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:
* * *

***

*****

- - -

---------------



六.字體樣式

1.強調,Markdown 使用星號(*)和底線(_)作為標記強調字詞的符號,效果如下:
*single asterisks斜體*    
_single underscores斜體(有的是下劃線)_
**double asterisks粗體**
__double underscores粗體__

會轉成:

single asterisks斜體
single underscores斜體(有的是下劃線)
double asterisks粗體
double underscores粗體

你可以隨便用你喜歡的樣式,唯一的限制是,你用什么符號開啟標簽,就要用什么符號結束。

2.強調也可以直接插在文字中間:

un**frigging**believable

unfriggingbelievable

3.文本兩端增加~~可以作為刪除線:
~~DeleteLine~~

轉換的效果如下:
DeleteLine

4.文本兩端增加==可以作為高亮:
==高亮==(簡書不支持)

==高亮==

5.上下標文字:
這是<sup>上標文字</sup>
這是<sub>下標文字</sub>

這是上標文字
這是下標文字



七.反斜杠

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號,比如:
\literal asterisks\*
轉換成的效果如下(
只是展示沒有轉成斜體的語法):

*literal asterisks*

Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:

\ 反斜線;  ` 反引號;  * 星號;  _ 底線;  {} 花括號;  [] 方括號;  () 括弧;
# 井字號;  + 加號;  - 減號;  . 英文句點;  ! 驚嘆號;

八.表格

表格的樣式最重要的就是第二行的占位符。

文本類型 | 文本類型| 文本類型
:-----|:------:|-----:
居左文本 | 居中文本 | 居右文本
文本類型 文本類型 文本類型
居左文本 居中文本 居右文本


九.超鏈接

Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式。不管是哪一種,鏈接文字都是用 [方括號] 來標記。

1.行內式的鏈接。
這是 [百度](http://baidu.com/ "百度") 的鏈接,這也是[百度](http://baidu.com/) 鏈接.

轉換成的效果如下:

這是 百度 的鏈接,這也是百度 鏈接.

2.可使用相對路徑鏈接到相同主機的資源。

See my [本地資源名](/相對路徑/) page for details.

轉化成的效果如下:

See my 本地資源名 page for details.

3.參考式鏈接,需要鏈接內容配合。
This is [百度][百度ID] reference-style link. 
This is [百度] [百度IDI] reference-style link.( 兩個方括號之間加個空格鍵也可以)

(鏈接內容,通過ID鏈接,鏈接內容會隱藏)
[百度ID]: http://baidu.com/  "百度Title"
[百度IDI]: http://baidu.com/  

轉換成的效果如下:

This is 百度 reference-style link.
This is 百度 reference-style link.( 兩個方括號之間加個空格鍵也可以)


十.圖片

Markdown 使用一種和鏈接很相似的語法來標記圖片,同樣也允許兩種樣式: 行內式和參考式。

1.行內式的圖片語法:
語法示例: ![圖片下方文字](圖片地址 "圖片title") 

![bloakChain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/
u=702257389,1274025419&fm=27&gp=0.jpg)

轉化成的效果如下:

bloakChain

圖片title可有可無。有些語法圖片下方文字不展示。

2.參考式的圖片語法:
![bloakChain][imageId]

[imageId]: https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/
u=702257389,1274025419&fm=27&gp=0.jpg "區塊鏈"
bloakChain
bloakChain

到目前為止, Markdown 還沒有辦法指定圖片的寬高,如果你需要的話,你可以使用普通的 <img> 標簽。



十一.腳注和注釋

1.使用"[^]"定義腳注,示例如下:
腳注[^1]為什么在上邊?
[^1]: 因為這個注釋會在文章的最后出現

腳注[1]為什么在上邊?

2.注釋只在文本編輯時出現:
<!--注釋-->

右側使用了注釋,但你看不見:



十二.Markdown中常用的Html標簽

1.字體(簡書不支持)
<font face="微軟雅黑" color="red" size="6">字體及字體顏色和大小</font>
<font color="#0000ff">字體顏色</font>
2.換行符
第一行
第二行 <br/>
使用換行符號\<br>后

第一行
第二行

使用換行符號<br>后

3.文本對齊方式(簡書不支持)
<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>
4.下劃線(簡書不支持)
<u>下劃線文本</u>


十三.任務列表(簡書不支持)

任務列表的內容支持其他格式的markdown語法

- [ ] 未選中的選項 [百度鏈接](http://baidu.com),__強調__
- [x] 選中的選項 

效果如下:

  • [ ] 未選中的選項 百度鏈接強調
  • [x] 選中的選項


十四.自動鏈接和目錄

1.自動鏈接

Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱,只要是用方括號包起來, 就會自動把它轉成鏈接。例如:

網址: <http://example.com/>
郵箱:   <address@example.com>

Markdown 會轉為:
網址:http://example.com/
郵箱: address@example.com


  1. 因為這個注釋會在文章的最后出現 ?

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容