Markdown基礎使用

小白先生哦發表於2020-12-29

最近在嘗試開始寫部落格,然後發現格式、排版這些比較麻煩且瑣碎,所以希望能夠有一個簡單易用的編寫工具。基於這個原因,便開始學習了一下Markdown,發現挺有趣的,所以在這裡整理一下各種基礎的使用,將各種用法進行一些簡單的串聯,方便後面的記憶和使用。

在學習中,主要參考的是RUNOOB。將它裡面的卡片串聯在這一篇文章中。

推薦使用軟體Typora,所見即所得。

說明:下面的所有展示效果,有效展示部分都是第一條豎線後面的內容。加上最外層的豎線主要是為了與原始文字內容做區分。


一、標題

支援使用等號 = 和減號 - 來標記,總共分為6級標題,按照符號個數分別為一級標題到六級標題。在符號後面使用一個空格將標題和內容分離。比如下面這段:

# 一級標題
## 二級標題
###### 六級標題,超過六個無效,#和標題之間使用空格隔開

其展示效果如下:

一級標題

二級標題

六級標題,超過六個無效,#和標題之間使用空格隔開

二、段落

包括段落的編排、字型設定、分割線、刪除線、下劃線和腳註的使用。

1、段落編排

段落的換行有兩種方式,一種是在一個段落的末尾使用兩個空格然後換行寫下一段落,另一種方式是中間使用空行來換行。兩者之間經過實測在展示效果上有些差別,使用空行進行換行的段落之間空隙要大於使用兩個空格進行換行的空隙。比如下面這段:

***
(使用兩個空格來換行)第一段  
(使用兩個空格來換行)第二段
***
(使用空行來換行)第一段內容

(使用空行來換行)第二段內容
***

其展示效果如下:


(使用兩個空格來換行)第一段
(使用兩個空格來換行)第二段


(使用空行來換行)第一段內容

(使用空行來換行)第二段內容


2、字型

支援使用斜體、粗體、粗斜體三種字型。使用單個*或者下劃線_包圍文字表示將文字顯示為斜體,使用兩個星號或者兩個下劃線包圍文字表示將文字顯示為粗體,三個星號或者三個下劃線就是將包圍的文字顯示為粗斜體。比如下面這段:

*使用星號標記的斜體文字*
_使用下劃線標記的斜體文字_
**使用兩個星號加粗**
__使用兩個下劃線加粗__
***使用三個星號加粗斜體***
___使用三個下劃線加粗斜體___

其展示效果如下:

使用星號標記的斜體文字
使用下劃線標記的斜體文字
使用兩個星號加粗
使用兩個下劃線加粗
使用三個星號加粗斜體
使用三個下劃線加粗斜體

3、分割線

上面分割線已經使用的足夠多了。可以使用三個及以上的星號、減號、下劃線來表示一條分割線,分割線行內不能有其它內容,可以在星號、減號、下劃線中間插入空格。比如下面這段:

***
* * *
*****
- - -
----------

其展示效果如下:






4、刪除線和下劃線

使用兩個波浪線~~包圍文字即可表示刪除線,使用<u></u>這對標籤包圍文字即可表示下劃線。比如下面這段:

~~使用兩個波浪線包圍起來表示刪除線~~
<u>使用這對標籤包圍起來表示下劃線</u>

其展示效果如下:

使用兩個波浪線包圍起來表示刪除線
使用這對標籤包圍起來表示下劃線

5、腳註

使用[]這個符號來標記腳註內容,內容放在[後面。比如下面這段:

什麼是腳註?[^這就是一段腳註]

其展示效果如下:

什麼是腳註?[^這就是一段腳註]


三、列表

列表是文章中經常使用到的項,分為有序列表和無序列表。無序列表使用星號*、加號+或者減號-來進行標記,這些標記後面要新增一個空格,然後再填寫內容。有序列表則是使用數字並加上.號來表示。比如下面這段:

### 無序列表
* 第一項
* 第二項
+ 第三項
- 第四項
### 有序列表
1. 第一項
2. 第二項
3. 第三項

其展示效果如下:

無序列表

  • 第一項
  • 第二項
  • 第三項
  • 第四項

有序列表

  1. 第一項
  2. 第二項
  3. 第三項

而列表與列表之間也可以是任意巢狀的,對於列表巢狀只需要在選項前面新增四個空格即可。比如下面這段:

* 第一項
  * 第1項
  * 第2項
  * 第3項
* 第二項
  * 第二項第一級巢狀
    * 第二項第三級巢狀
* 第三項
  1. 第1項
  2. 第2項

其展示效果如下:

  • 第一項
    • 第1項
    • 第2項
    • 第3項
  • 第二項
    • 第二項第一級巢狀
      • 第二項第三級巢狀
  • 第三項
    1. 第1項
    2. 第2項

四、區塊

如上,各個展示效果都是放在區塊中進行展示的,使用>符號進行表示,一個>符合表示最外層,兩個>符號表示第一層的巢狀,以此類推。比如下面這段:

> 第一層指示-1
>> 第一層指示分類點1
>> 第一層指示分類點2
>
> 第一層指示-2
>
> 第一層指示-3
注意:如果上一層級的子巢狀要結束,然後恢復到上一層級,中間要使用一個 '> 空行' 來分隔

其展示效果如下:

第一層指示-1

第一層指示分類點1
第一層指示分類點2

第一層指示-2

第一層指示-3

注意:如果上一層級的子巢狀要結束,然後恢復到上一層級,中間要使用一個 '> 空行' 來分隔

同時區塊可以結合列表來使用,其實在上面的展示中就已經使用到了。


五、程式碼

在上面各段程式碼中展示的markdown語句,之所以沒有按照展示效果中的樣式解析出來,就是因為包含在了程式碼塊中。使用三個波浪線~~~來包裹一段程式碼,並指定一種語言,也可以不指定。比如下面這段:

​~~~markdown
### 這是一段程式碼
​~~~

其展示效果如下:

### 這是一段程式碼

(### 這是一段程式碼 ) 依然沒有被解析為三級標題。


六、連結

比如下面這段:

RUNOOB連結 [RUNOOB](https://www.runoob.com)

其展示效果如下:

RUNOOB連結 RUNOOB


七、圖片

圖片這個有點不好用,typora不方便將本地的圖片複製到其他地方去,比如在本地編寫好文章,裡面插入圖片,然後複製到其它釋出平臺是沒法複製過去的。而有一些編輯器使用圖片上傳功能需要付費。這裡就複製一下它的樣例吧,如下:

![RUNOOB 圖示](https://i.iter01.com/images/7f84698651df1ffbb8824709dd813092d56e9298196cc203bc50abcac8f9de8c.png)

其展示效果如下:

RUNOOB 圖示


八、表格

表格使用當然是必不可少的。使用|來分隔不同的單元格,使用-來分隔表頭和其它行。同時可以設定表格的對齊方式,如下:

  • -: 設定內容和標題欄右對齊
  • :- 設定內容和標題欄左對齊
  • :-: 設定內容和標題欄居中對齊

比如下面這段:

| 左對齊 | 居中對齊 | 右對齊 |
| :---- | :----:  | ----: |
| 單元格 | 單元格   | 單元格 |
| 單元格 | 單元格   | 單元格 |

其展示效果如下:

左對齊 居中對齊 右對齊
單元格 單元格 單元格
單元格 單元格 單元格

九、轉義

在上面的文件中出現了各種Markdown的特殊字元,但是依然原樣顯示出來,沒有被解析成為各種樣式,就是使用了轉義字元 \,使用\就表示後面的字元要原樣輸出,不要進行解析。比如我要顯示三個星號而不是分隔線,對應如下:

\*\*\*

其展示效果如下:

***


十、高階技巧

看了一下Markdown甚至支援使用HTML元素,各種數學公式、流程圖、時序圖、甘特圖支援,真的是太強大了。

後面有時間了再來完整的整理一下Markdown的高階用法~~~