Markdown入門語法整理

2021-08-10 20:57:38 字數 4565 閱讀 6098

說明:此文件只涉及markdown相關基礎知識,不對html語法進行解釋

1.標題

1.1 類setext形式

類 setext 形式是用底線的形式,利用=(最高端標題)和-(第二階標題),例如:

this is an h1

**********===

this is an h2

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

1.2 類atx 形式

# 這是 h1

## 這是 h2

###### 這是 h6

可以在行尾加上 #,而行尾的 # 數量也不用和開頭一樣(行首的井字元數量決定標題的階數):

# 這是 h1 #

## 這是 h2 ##

### 這是 h3 ######

2.列表

2.1    '- '      '+ '      '1. ' 都行

- 文字1

- 文字2

- 文字3

2.2 如果要求序列化

1. 文字1

2. 文字2

3. 文字3

列表專案可以包含多個段落,每個專案下的段落都必須縮排 4 個空格或是 1 個製表符:

* this is a list item with two paragraphs.

this is the second paragraph in the list item. you're

only required to indent the first line. lorem ipsum dolor

sit amet, consectetuer adipiscing elit.

* another item in the same list.

如果要在列表專案內放進引用,那 > 就需要縮排:

* a list item with a blockquote:

> this is a blockquote

> inside a list item.

3.鏈結和

#自動鏈結

#郵箱位址鏈結

!插入

4.引用

前面加》就可以,以空行結束引用

區塊引用可以巢狀(例如:引用內的引用),只要根據層次加上不同數量的 >:

> this is the first level of quoting.

>

> > this is nested blockquote.

>

> back to the first level.

引用的區塊內也可以使用其他語法,包括標題、列表、**區塊等:

> ## 這是乙個標題。

> 1.  這是第一行列表項。

> 2.  這是第二行列表項。

> 給出一些例子**:

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

5.粗體與斜體

兩個*或_包含一段文字就是粗體的語法,用乙個*或_包含一段文字就是斜體的語法。

6.**引用

需要引用**時,如果引用的語句只有一段,不分行,可以用--

將語句包起來,這個符號是鍵盤左上角的那個。

'**'

如果引用的語句為多行,可以將--置於這段**的首行和末行顯示行號

```**

```**內插入」 ` 「反引號,則需要加兩個``反引號:

``there is a literal backtick (`) here.``

或者在``後面加乙個空格:

a single backtick in a code span: `` ` ``

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

另外,要在 markdown 中建立**區塊很簡單,只要簡單地縮排 4 個空格或是 1 個製表符就可以,但是不顯示行號,例如,下面的輸入:

這是乙個普通段落:

這是乙個**區塊。

7.**

示例1:

| tables        | are           | cool  |

| ------------- |:-------------:| -----:|

| col 3 is      | right-aligned | $1600 |

| col 2 is      | centered      | $12   |

| zebra stripes | are neat      | $1    |

顯示效果:

tables

arecool

col 3 is

right-aligned

$1600

col 2 is

centered

$12zebra stripes

are neat$1

示例2:

dog | bird | cat

----|------|----

foo | foo | foo

bar | bar | bar

baz | baz | baz

顯示效果;

dogbird

catfoo

foofoo

barbar

barbaz

bazbaz

8.縮排

使用乙個'*'號,後面空格表示縮排位數:

*  lorem ipsum dolor sit amet, consectetuer adipiscing elit.

aliquam hendrerit mi posuere lectus. vestibulum enim wisi,

viverra nec, fringilla in, laoreet vitae, risus.

*  donec sit amet nisl. aliquam semper ipsum sit amet velit.

suspendisse id sem consectetuer libero luctus adipiscing.

等同於:

*  lorem ipsum dolor sit amet, consectetuer adipiscing elit.

aliquam hendrerit mi posuere lectus. vestibulum enim wisi,

viverra nec, fringilla in, laoreet vitae, risus.

*  donec sit amet nisl. aliquam semper ipsum sit amet velit.

suspendisse id sem consectetuer libero luctus adipiscing.

9.分割線

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

* * *

***

*****

- - -

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

10.反斜槓

markdown 支援以下這些符號前面加上反斜槓來轉義特殊字元:

\ 反斜線

` 反引號

* 星號

_ 底線

{} 花括號

方括號() 括弧

# 井字型大小

+ 加號

- 減號

. 英文句點

! 驚嘆號

11.相容html

在 markdown 檔案裡加上一段 html **, 、、、等標籤,必須在前後加上空行與其它內容區隔開,還要求它們的開始標籤與結尾標籤不能用製表符或空格來縮排:

這是乙個普通段落。

foo

這是另乙個普通段落

具體html語法,這裡不再說明,需要的可參考:

markdown 語法說明(簡體中文版),以及文件

html語法

參考:markdown 語法說明(簡體中文版)、markdown 新手指南

常用 Markdown 語法整理

在 markdown 中常用的文字顏色有 紅色文字 color red 紅色文字font 淺紅色文字 color dd0000 淺紅色文字font 藍色文字 color blue 藍色文字font 淺藍色文字 color 0000dd 淺藍色文字font 綠色文字 color green 綠色文字f...

MarkDown語法快速入門

主要內容 markdown是什麼?誰發明了這麼個東西?為什麼要使用它?怎麼使用?都誰在用?markdown是一種輕量級標記語言,它以純文字形式 易讀 易寫 易更改 編寫文件,並最終以html格式發布。markdown也可以理解為將以markdown語言編寫的語言轉換成html內容的工具,最初是乙個p...

Markdown語法與入門

markdown 是一種輕量級的 標記語言 它的優點很多,目前也被越來越多的寫 好者,撰稿者廣泛使用。看到這裡請不要被 標記 語言 所迷惑,markdown 的語法十分簡單。常用的標記符號也不超過十個,這種相對於更為複雜的html 標記語言來說,markdown 可謂是十分輕量的,學習成本也不需要太...