1. 程式人生 > >Markdown語法圖文全面詳解(10分鐘學會)

Markdown語法圖文全面詳解(10分鐘學會)

轉自碼個蛋公眾號

目錄

前言
寫過部落格或者github上面的文件的,應該知道Markdown語法的重要性,不知道的朋友們也彆著急,一篇部落格輕鬆搞定Markdown語法。話說這個語法超級簡單,一看就會,不信你點進來看看。

1. 快捷鍵

跳轉到目錄

功能 快捷鍵
加粗 Ctrl + B
斜體 Ctrl + I
引用 Ctrl + Q
插入連結 Ctrl + L
插入程式碼 Ctrl + K
插入圖片 Ctrl + G
提升標題 Ctrl + H
有序列表 Ctrl + O
無序列表 Ctrl + U
橫線 Ctrl + R
撤銷 Ctrl + Z
重做 Ctrl + Y

2. 基本語法

跳轉到目錄

2.1 字型設定斜體、粗體、刪除線

*這裡是文字*
_這裡是文字_
**這裡是文字**
***這裡是文字***
~~這裡是文字~~

這裡寫圖片描述

2.2 分級標題

跳轉到目錄
寫法1:

# 一級標題## 二級標題### 三級標題#### 四級標題##### 五級標題###### 六級標題  這個寫法和 **文字**效果是一樣的

這裡寫圖片描述

寫法2:

這是一個一級標題
============================

或者

二級標題
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -


這裡寫圖片描述

2.3 連結

跳轉到目錄
(1)插入本地圖片連結
語法規則,有兩種寫法:
這裡寫圖片描述
注意:這個圖片描述可以不寫。

示例圖如下:
這裡寫圖片描述

(2)插入網際網路上圖片
語法規則:
這裡寫圖片描述
注意:這個圖片描述可以不寫。

示例如下:
這裡寫圖片描述
(3)自動連線
Markdown 支援以比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用<>包起來, Markdown 就會自動把它轉成連結。也可以直接寫,也是可以顯示成連結形式的
例如:
這裡寫圖片描述

2.4 分割線

跳轉到目錄
你可以在一行中用三個以上的星號(*)、減號(-)、底線(_)來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。
這裡寫圖片描述

2.5 程式碼塊

跳轉到目錄
對於程式設計師來說這個功能是必不可少的,插入程式程式碼的方式有兩種,一種是利用縮排(tab), 另一種是利用英文“`”符號(一般在ESC鍵下方,和~同一個鍵)包裹程式碼。

(1)程式碼塊:縮排 4 個空格或是 1 個製表符。效果如下:
這裡寫圖片描述
(2)行內式:如果在一個行內需要引用程式碼,只要用反引號`引起來就好(一般在ESC鍵下方,和~同一個鍵)
這裡寫圖片描述

(3)多行程式碼塊與語法高亮:在需要高亮的程式碼塊的前一行及後一行使用三個單反引號“`”包裹,就可以了。
示例如下:
這裡寫圖片描述

(4)程式碼塊裡面包含html程式碼
在程式碼區塊裡面, & 、 < 和 > 會自動轉成 HTML 實體,這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼,只需要複製貼上,剩下的 Markdown 都會幫你處理。

注意:簡書程式碼塊裡不支援html。

示例如下:
這裡寫圖片描述

2.6 引用

跳轉到目錄
在被引用的文字前加上>符號,以及一個空格就可以了,如果只輸入了一個>符號會產生一個空白的引用。

(1)基本使用
使用如下圖所示:
這裡寫圖片描述

(2)引用的巢狀使用
使用如圖所示:
這裡寫圖片描述
(3)引用其它要素
引用的區塊內也可以使用其他的 Markdown 語法,包括標題、列表、程式碼區塊等。
使用如圖所示:
這裡寫圖片描述

2.7 列表

跳轉到目錄
(1)無序列表
使用 *,+,- 表示無序列表。
注意:符號後面一定要有一個空格,起到縮排的作用。
這裡寫圖片描述

(2)有序列表
使用數字和一個英文句點表示有序列表。
注意:英文句點後面一定要有一個空格,起到縮排的作用。
這裡寫圖片描述

(3)無序列表和有序列表同時使用
這裡寫圖片描述

(4)列表和其它要素混合使用
列表不光可以單獨使用,也可以使用其他的 Markdown 語法,包括標題、引用、程式碼區塊等。

注意事項:

(1)加粗效果不能直接用於列表標題裡面,但是可以巢狀在列表裡面混合使用。
(2)列表中包含程式碼塊(前面加2個tab或者8個空格,並且需要空一行,否則不顯示)。
.
使用示例如下圖:
這裡寫圖片描述

(5)注意事項
在使用列表時,只要是數字後面加上英文的點,就會無意間產生列表,比如2017.12.30 這時候想表達的是日期,有些軟體把它被誤認為是列表。解決方式:在每個點前面加上\就可以了。如下圖所示:
這裡寫圖片描述

2.8 表格

跳轉到目錄
表格的基本寫法很簡單,就跟表格的形狀很相似:
這裡寫圖片描述

表格對齊方式:我們可以指定表格單元格的對齊方式,冒號在左邊表示左對齊,右邊表示有對齊,兩邊都有表示居中。

如下圖所示:
這裡寫圖片描述

3. 常用技巧

3.1 換行

方法1: 連續兩個以上空格+回車
方法2:使用html語言換行標籤:

3.2 縮排字元

不斷行的空白格   或  半形的空格   或  全形的空格   或  
這裡寫圖片描述

3.3 特殊符號

(1)對於 Markdown 中的語法符號,前面加反斜線\即可顯示符號本身。

示例如下:
這裡寫圖片描述

附上幾個工具對特殊字元的支援的對比圖:
這裡寫圖片描述

3.4 字型、字號與顏色

Markdown是一種可以使用普通文字編輯器編寫的標記語言,通過類似HTML的標記語法,它可以使普通文字內容具有一定的格式。但是它本身是不支援修改字型、字號與顏色等功能的!

CSDN-markdown編輯器是其衍生版本,擴充套件了Markdown的功能(如表格、腳註、內嵌HTML等等)!對,就是內嵌HTML,接下來要講的功能就需要使用內嵌HTML的方法來實現。

字型,字號和顏色編輯如下程式碼
這裡寫圖片描述

具體顏色分類及標記請看下錶:
這裡寫圖片描述

3.5 連結的高階操作

連結的高階操作(這個需要掌握一下,很有用)

1.行內式

這個在上文第二條基本語法的 連結這個小節已經過,這裡就不繼續講解了。

2.參考式連結

在文件要插入圖片的地方寫![圖片或網址連結][標記],在文件的最後寫上[標記]:圖片地址 “標題”。(最後這個”標題”可以不填寫)

示例如下:
這裡寫圖片描述

3.內容目錄

在段落中填寫 [TOC] 以顯示全文內容的目錄結構。

4.錨點

錨點其實就是頁內超連結。比如我這裡寫下一個錨點,點選回到目錄,就能跳轉到目錄。 在目錄中點選這一節,就能跳過來。

注意:在簡書中使用錨點時,點選會開啟一個新的當前頁面,雖然錨點用的不是很舒服,但是可以用註腳實現這個功能。

語法說明:
在你準備跳轉到的指定標題後插入錨點{#標記},然後在文件的其它地方寫上連線到錨點的連結。

使用如下圖所示:
這裡寫圖片描述

5.註腳

語法說明:
在需要添加註腳的文字後加上腳註名字[^註腳名字],稱為加註。 然後在文字的任意位置(一般在最後)新增腳註,腳註前必須有對應的腳註名字。

示例如下:
這裡寫圖片描述
注:

  1. 腳註自動被搬運到最後面,請到文章末尾檢視,並且腳註後方的連結可以直接跳轉回到加註的地方。
  2. 由於簡書不支援錨點,所以可以用註腳實現頁面內部的跳轉。

3.6 背景色

Markdown本身不支援背景色設定,需要採用內建html的方式實現:藉助 table, tr, td 等表格標籤的 bgcolor 屬性來實現背景色的功能。舉例如下:

<table><tr><td bgcolor=orange>背景色是:orange</td></tr></table>

這裡寫圖片描述

3.7 emoji表情符號

當然現在很多markdown工具或者網站都不支援。

下面列出幾個平臺的對比:

工具或網站 是否支援emoji表情符號
簡書
MarkDownPad 否(不知道付費版是否支援)
有道雲筆記
zybuluo.com
github

這裡寫圖片描述

4. 高階用法

4.1 Latex數學公式

使用LaTex數學公式

1.行內公式:使用兩個”$”符號引用公式:

$公式$

2.行間公式:使用兩對“$$”符號引用公式:

$$公式$$

輸入$\sqrt{x^{2}}$
顯示結果是x2

4.2 流程圖

這裡簡單介紹一下流程圖的語法,僅作為了解,如下圖所示:
這裡寫圖片描述

4.3 製作一份待辦事宜—-Todo 列表

這裡寫圖片描述

4.4 繪製 序列圖

這裡寫圖片描述

4.5 繪製 甘特圖

這裡寫圖片描述

5. Markdown工具

1.markdownpad軟體,就是利用markdown語言寫筆記的。官網下載地址:http://markdownpad.com/

軟體安裝之後的示意圖如下圖所示:
這裡寫圖片描述

2.有道雲筆記支援markdownpad語法。官方網址:http://note.youdao.com/ 它有線上網頁版以及PC端可以下載。當然有道雲筆記也支援html語法。

網頁版使用markdown示例圖如下:
這裡寫圖片描述

本文參考文章: