概述
Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文本格式編寫文檔,然后轉換成格式豐富的HTML頁面。 —— 來自[維基百科]
簡單的來說,Markdown就是用“標記符號”表示“格式”。Markdown語法標簽與HTML語法標簽是一一對應的,比如Markdown的二級標題標簽##就對應著HTML中的<h2>...</h2>
標記,而且Markdown是兼容HTML語法的,如果你比較喜歡 HTML 的<a>
或 <img>
標簽,可以直接在Markdown文檔中使用這些標記,而不用 Markdown 提供的鏈接或是圖像標簽語法。
段落與換行
一個 Markdown 段落是由一個或多個連續(xù)的文本行組成,它的前后要有一個以上的空行(空行的定義是顯示上看起來像是空的,便會被視為空行。若某一行只包含空格和制表符,也會被視為空行)。Markdown 允許段落內的強迫換行(插入換行符),普通段落不該用空格或制表符來縮進。
標題
Markdown 支持兩種標題的語法,類 Setext 和類 atx 形式。
類 Setext 形式是用底線的形式,利用 =(最高階標題)和 -(第二階標題)。
This is an H1
=========
This is an H2
----------------
顯示效果:
This is an H1
=========
This is an H2
類 Atx 形式則是在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階,例如:
# 這是 H1
## 這是 H2
#### 這是 H4
顯示效果:
這是 H1
這是 H2
這是 H4
區(qū)塊引用 Blockquotes
Markdown 文件中建立一個區(qū)塊引用,那會看起來像是你自己先斷好行,然后在每行的最前面加上>
,最好和文字之間保留一個空格。
Markdown 也允許你偷懶只在整個段落的第一行最前面加上>
> This is a blockquote with two paragraphs. 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.
顯示出來會變成:
This is a blockquote with two paragraphs. 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.
區(qū)塊引用可以嵌套(例如:引用內的引用),只要根據(jù)層次加上不同數(shù)量的>
,而且引用的區(qū)塊內也可以使用其他的 Markdown 語法喲,標題,列表,代碼區(qū)快都可以用,還是很方便很優(yōu)雅的~
舉例:
> ## she
> This is a blockquote with two paragraphs. 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.
真實顯示是這樣的
she
This is a blockquote with two paragraphs. 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.
列表
列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - 就可以了。當然啦,在-
、1.
和文本之間也要保留一個字符的空格才是標準語法。
例如:
- 這是第一行
- 這是第二行
- 這是第三行
實際顯示:
- 這是第一行
- 這是第二行
- 這是第三行
如果想要展示一個有序列表,也可以在文字前面加上 1. 2. 3.,例如:
1.文本1
2.文本2
3.文本3
實際顯示:
1.文本1
2.文本2
3.文本3