Markdown:入門教程

本文將會從 Markdown 最重要的幾點知識元素進行入門學習。

(PS:本文中,配圖部分,均選用了 VSCode 作爲 Markdown 編輯器進行效果演示)


Markdown 入門必知:

  • 標題
  • 列表
  • 鏈接和圖片
  • 引用
  • 粗體和斜體
  • 代碼
  • 表格

首先,看下 Markdown 的優點:

  • 純文本
  • 可以讓你專注於文字而不是排版
  • 格式轉換方便(Markdown 的文本,你可以輕鬆轉換爲 html、pdf、word、ppt 等格式)
  • Markdown 的標記語法有極好的可讀性

下面,直接入正題 ……

標題

這是最爲常用的格式。在平時常用的的文本編輯器中大多是這樣實現的:輸入文本、選中文本、設置標題(文本)格式

而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你還可以增加二級標題、三級標題、四級標題、五級標題和六級標題,總共六級,只需要增加 # 即可,標題字號相應降低。例如:

注: #「一級標題」 之間建議保留一個字符的空格,這是最標準的 Markdown 寫法。

(PS:這個其實和網頁中的標題是一致的,分別對應 html 中的 <h1></h1> …… <h6></h6> 的標籤。)

列表

列表可以分爲無序列表和有序列表,它們分別對應於 html 中的 <ul></ul> 和<ol></ol> 。這個也是非常常用的。

Markdown 中的無序列表,你只需要在文字前面加上 - 就可以了。

Markdown 中的有序列表,只需要在文字前面加上 1. 就可以了(注意了:事實上,這個可以是任意一個阿拉伯數字再加上一個英文的句號,都可以。而不一定是 1.,也可以是2.,甚至是 111.,對於這個阿拉伯數字到底是幾沒有要求。Markdown 中會自動按着最正確的數字順序進行“有序排列”。)。 例如:

注:-1.和文本內容之間要保留一個字符的空格

鏈接和圖片

在 Markdown 中,插入鏈接不需要其他按鈕,你只需要使用 [顯示文本](鏈接地址) 這樣的語法即可。

在 Markdown 中,插入圖片也不需要其他按鈕,你只需要使用 ![](圖片鏈接地址) 這樣的語法即可。

兩者的語法非常相似。但唯一的區別是,插入圖片只是比插入鏈接多了前面的一個 ! ,並且插入圖片不需要 [顯示文本] 部分,內部是置空的,即 []。例如:

注:插入圖片的語法和鏈接的語法很像,只是前面多了一個 (並且 [顯示文本] 置空)。

Markdown 中,鏈接是可以點擊的,並且點擊後會跳轉到默認瀏覽器去打開鏈接所指定的網址。

但是,圖片卻是隻能顯示,並不能點擊的。

引用

總會有一些時候,我們寫的文字需要 引用 一些其他著作上的文字,那麼就可以將 引用 派上用場了。

引用 的使用方法也很簡單:你只需要在你想要 引用 的文字前面加上符號 > 。例如:

注:> 和文本之間要保留一個字符的空格

粗體和斜體

在 Markdown 中,粗體和斜體,使用上也很簡單。

左右各兩個 * 中間包裹的文字,就是粗體的; 左右各一個 *,中間包裹的文字,就是斜體的。 如圖:

代碼

對於開發者而言,最關心的莫過於如何插入代碼了.

對於插入塊級代碼(單行或多行), 需要連用 3 個 ` 單獨佔據一行開頭,表示開始插入代碼塊;並且連用 3 個 ` 並且單獨佔據一行,表示插入代碼塊結束. 如圖:

注: 開頭的 3 個 ` 後面聲明一下插入的代碼塊的語言, Markdown 在顯示的時候就可以自動按照正確的方式(語法格式)進行代碼塊的配色了. 推薦必須帶上.

對於插入行內代碼,只需要兩端各使用 1 個 ` ,中間包裹的內容,即爲代碼元素. 如圖:

PS: (補充內容)` 這個“反撇號”的字符,該如何輸入呢?

  1. 必須先確保輸入法在英文狀態下;
  2. 按鍵盤上 ~ 波浪號鍵 即可完成輸入.

(~ 它的位置在:Tab 鍵正上面, 同時它也是在 ESC 鍵的正下面). (如下圖)

表格

Markdown 中使用 | 進行表格的快速插入。如圖:

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章