初識Markdown

*一、Markdown是什么 *

Markdown是一種輕量級的標記語言,使用的標記語法非常簡單,它可以使用純文本編輯器來創建豐富的文本,并可以被轉換為.html、.pdf和本身的.md文件。

二、Markdown常用語法

1. 標題

Markdown支持兩種標題的語法,類 Atx 和類 Setext形式。

1.1 類 Atx 形式

在文字前加#即可定義標題,共六級標題,#與標題之間加一空格,如下:

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

效果如下:

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

<br />

1.2 類 Setext 形式

個人覺得不如類Atx方便,這里就不介紹了,有興趣的可以參考Markdown 中文版語法說明

2. 引用

2.1 單行引用

引用別處的文字,可以使用>加引用的內容即可,符號和引用內容之間加一空格。

> 這里是引用的內容

效果如下:

這里是引用的內容

2.2 區塊引用

也可以區塊引用:

> 這里是引用區塊的內容
> 這里是引用區塊的內容
> 這里是引用區塊的內容

還可以只在整個段落的第一行最前面加上>來區塊引用:

> 這里是引用區塊的內容,這里是引用區塊的內容;
這里是引用區塊的內容,這里是引用區塊的內容。
這里是引用區塊的內容,這里是引用區塊的內容。

效果如下:

這里是引用區塊的內容
這里是引用區塊的內容
這里是引用區塊的內容

2.3 引用嵌套

區塊引用還可以嵌套使用:

> 這里是引用區塊的內容
> > 這里是嵌套的引用區塊的內容

效果如下:

這里是引用區塊的內容

這里是嵌套的引用區塊的內容

2.4 嵌套其他

引用區塊內還可以嵌套使用其他的 Markdown 語法,如標題、列表、代碼區塊等:
> 這是引用區塊
> #引用區塊內的標題一
> * 引用區塊內的列表
> \ <p>Markdown<p/>` `

效果如下:

這是引用區塊

引用區塊內的標題

  • 引用區塊內的列表
    <p>Markdown<p/>

3. 列表

在文字前加上+、-或者*即可變為無序列表,加上1. 2. 3. 即可變為有序列表,符號和列表項內容之間加一空格。

3.1 無序列表

+ 無序列表項1
+ 無序列表項2
+ 無序列表項3

- 無序列表項1
- 無序列表項2
- 無序列表項3
或者
* 無序列表項1
* 無序列表項2
* 無序列表項3

效果如下:

  • 無序列表項1
  • 無序列表項2
  • 無序列表項3

3.2 有序列表

1. 有序列表項1
2. 有序列表項2
3. 有序列表項3

有序列表標記上使用的數字并不會影響輸出的結果,如下:
1. 有序列表項1
1. 有序列表項2
1. 有序列表項3
或者
3. 有序列表項1
2. 有序列表項2
8. 有序列表項3

輸出的效果都是如下所示的有序列表:

  1. 有序列表項1
  2. 有序列表項2
  3. 有序列表項3

不過建議第一個列表項目最好還是從1. 開始,因為 Markdown 未來可能會支持有序列表的 start 屬性,即設置有序列表起始列表項的序列號數字。

3.3 列表縮進

列表項標記也可以縮進,最多 3 個空格,項目標記后面則一定要接著至少一個空格或制表符。
列表項標記也可以包含多個段落,每個項目下的段落都必須縮進 4 個空格或 1 個制表符。
當我們需要讓列表看起來更漂亮時,就可以把內容用固定的縮進整理好。
* 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項, 內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表。 項內容這里是列表項內容這里是列表項內容這里是列表項內容。
* 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項, 內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表; 項內容這里是列表項內容這里是列表項內容這里是列表項內容。
或者不整理:
* 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項, 內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表。 項內容這里是列表項內容這里是列表項內容這里是列表項內容。
* 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項, 內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表; 項內容這里是列表項內容這里是列表項內容這里是列表項內容。

效果是一樣的,如下:

  • 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項,
    內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表。
    項內容這里是列表項內容這里是列表項內容這里是列表項內容。
  • 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項,
    內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表;
    項內容這里是列表項內容這里是列表項內容這里是列表項內容。

3.4 列表嵌套其他內容

在列表項目內放引用時,> 需要縮進。放代碼區塊的話,該區塊就需要縮進* 兩次*,也就是 8 個空格或者 2 個制表符。
* 列表項
> 引用
* 列表項
<p>這里是代碼<p/>

效果如下:

  • 列表項

    引用

  • 列表項
    <p>這里是代碼<p/>

3.5 意外列表

無意中產生的列表:

1986. What a great season.

效果如下:

  1. What a great season.

可以做如下處理:

1986\. What a great season.

效果如下:

1986. What a great season.

也就是在行首出現數字-句點-空白,要避免這樣的狀況,可以在句點前面加上反斜杠轉義。

4. 代碼區塊與分割線

4.1 代碼區塊

Markdown 中建立代碼區塊很簡單,只要簡單地縮進 4 個空格或是 1 個制表符就可以了。不過貌似簡書需要兩個制表符才行。

<h2>代碼區塊的標題<h2/>
<p>代碼區塊的內容<p/>

效果如下:

<h2>代碼區塊的標題<h2/>
<p>代碼區塊的內容<p/>

一個代碼區塊會一直持續到沒有縮進的那一行(或是文件結尾)。

如果要標記一小段行內代碼,你可以用反引號`把它包起來。如\ <p> <p/>` 效果為 <p> <p/>`。

4.4 分割線

在一行中用三個以上的星號、減號、底下劃線來建立一個分隔線,行內不能有其他東西。不過可以在星號或是減號中間插入空格。
***
---
___
* * *
- - -
_ _ _
效果一樣的,如下:


如果要做連續的下劃線,最好在每一行的符號后面加一空行,不然可能會出問題,不知是簡書這樣還是都是這樣。

5. 鏈接與圖片

插入鏈接與插入圖片的語法很像,區別在于插入圖片前面多一個感嘆號!

5.1 插入鏈接

[鏈接描述](這里是鏈接的地址)

效果如下:
這里是鏈接的描述

5.2 插入圖片

插入圖片的地址需要圖床,別人推薦 CloudApp 的服務,生成URL地址即可。ps:我沒有用過<sub />
簡書可以直接把圖片拖過來。
![圖片描述](圖片URL "圖片title") <small>——圖片title是可選項<small />

效果如下:


乘風破浪

6. 強調和轉義

Markdown 使用星號*和底線_作為標記強調字詞的符號。
用一個*或者_包含一段文本得到的是斜體,用兩個*或者_ 包含一段文本得到的是粗體。開始和結束的符號要相同。轉義在前面加上轉義字符 \ 即可,如:*。

*斜體*
**粗體**
_斜體_
__粗體__

效果如下:

斜體 粗體斜體 粗體

*_兩邊都有空白的話,它們就只會被當成普通的符號。如*結果就是 *, _結果就是 _ 。
如果要在文字前后直接插入普通的星號或底線,你可以用反斜線轉義。如\*結果就是*, \_結果就是 _ 。

6. 表格

表格是比較麻煩的
|表頭 |表頭|表頭|表頭| | -|:--| ---:| :----:| |單元格| |單元格|單元格| |單元格|單元格|單元格|單元格| |單元格|單元格|單元格|單元格|

  • ||表示空單元格
  • 表頭下一行中-數量無關單元格寬度,根據列數均分寬度
  • 表頭下一行中的:表示的是文字的對齊方式,不設置則只是表頭文字居中;在-左邊則居左,右邊居右,在-兩邊各有一個:則居中
  • 合并單元格等其他單元格有關內容另行搜索

效果如下:
表格與整個表格前面的文字之間需要加一空行。

表頭 表頭 表頭 表頭
單元格 單元格 單元格
單元格 單元格 單元格 單元格
單元格 單元格 單元格 單元格

總結

以上是我在簡書上學習使用Markdown的練習,感覺<big>空一行<big />好重要啊,很多時候因為沒有空一行都會導致一些意外。
本文主要參考Markdown 中文版語法說明。如果想要了解更多有關Markdown語法的內容,請閱讀Markdown 中文版語法說明

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,533評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,055評論 3 414
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,365評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,561評論 1 307
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,346評論 6 404
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,889評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 42,978評論 3 439
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,118評論 0 286
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,637評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,558評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,739評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,246評論 5 355
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 43,980評論 3 346
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,362評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,619評論 1 280
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,347評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,702評論 2 370

推薦閱讀更多精彩內容

  • 前言: Markdown所具備的諸多優點,致使其在程序員、極客圈、自媒體圈和作家圈非常流行。 markdown優點...
    波段頂底閱讀 3,664評論 0 5
  • 開始是使用為知筆記作為平時的記錄, 發現為知可以安裝插件 「 Editor.md 」使用 Markdown 寫...
    AlvinMi閱讀 341評論 0 0
  • 一、概述# Markdown是一種輕量級的標記語言,他的目標是實現易讀易寫,一份使用Markdown格式撰寫的文件...
    sunnyaxin閱讀 1,540評論 2 3
  • 標題黨,是我前天買的一本書的名字,瘋狂英語創始人李陽的書。 我喜歡看書,但一般情況下不買書。很簡單,因為我要省錢。...
    楊文華閱讀 1,220評論 0 1
  • 晚安 愿今夜的你好夢 酣睡到天亮 么么噠
    來福是只貓閱讀 132評論 0 0