說明:此文件只涉及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 可謂是十分輕量的,學習成本也不需要太...