MarkDown 基本語法

一、MarkDown是什么好東西?

1.認識MarkDown

MarkDown 是一個 Web 上使用的文本到HTML的轉換工具,可以通過簡單、易讀易寫的文本格式生成結構化的HTML文檔,MarkDown中文教程(教程-MarkDown)上的介紹,讀完有點懵。簡單理解,MarkDown格式很簡單,然后以MarkDown格式書寫的文章可以直接以純文本發(fā)布到支持Markdown編輯模式的平臺上,省去排版的困擾。

2.MarkDown優(yōu)點

  • 簡單直觀易學
  • 純文本內(nèi)容,專心考慮內(nèi)容,無需困擾排版
  • 可以運用在幾乎任何有文字的地方

二、有哪些MarkDown的基本語法?

1.標題

MarkDown通過在行首添加1-6個 # 符號+空格來定義1-6級標題(有的網(wǎng)站不加空格也能識別,但是最好加)。

  • 書寫格式
    # 一級標題
    ## 二級標題
    ### 三級標題
    #### 四級標題
    ##### 五級標題
    ###### 六級標題
    眼花繚亂的#,數(shù)數(shù)數(shù)到眼睛疼

  • 解析效果

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

在簡書上寫這篇博客的時候發(fā)現(xiàn)一個很有趣的東西,哈哈,上圖
本來想加無序列表的,結果剛打- 上去就把前面的文字變成標題了

在- 后加了文字就正常了

查了一下,是因為可以使用=(高階標題) 和- (次階標題)來標記一級和二級標題,任何數(shù)量的= 和- 都有效果。

  • 書寫格式

一級標題
=
二級標題
-

  • 解析效果

一級標題

二級標題


2. 段落

直接寫內(nèi)容就顯示為段落,就是這么簡單粗暴。

  • 書寫格式
    這是一個段落
  • 解析效果
    這是一個段落

看起來沒有毛線區(qū)別

3.插入圖片

語法:! [ 圖片下方顯示的東西,可以隨便寫什么也可以不寫 ] ( 圖片的線上地址,可以加標題也可以不加 )。本地圖片可以使用圖床,具體方法可自行查閱。![]()

  • 書寫格式


  • 解析效果


注:和HTML相同,插入的圖片也可以有一個鼠標懸浮在圖片上放就顯示設置的標題的效果,簡單的在圖片地址后面加"Title",Title就是鼠標懸浮顯示的標題。

4.插入鏈接

語法:[ 鏈接顯示文字 ]( 鏈接地址 "Title" ),Title即鼠標懸浮到此處顯示的標題,可加可不加。

5.文字效果

加粗

兩種方式:兩個(*)或者底線(_)作為標記強調(diào)字詞的符號,將需要加粗的文字包圍即可。

斜體

兩種方式:一個(*)或者底線(_)作為標記強調(diào)字詞的符號,將需要傾斜的文字包圍即可。

加粗+斜體

兩種方式:三個(*)或者底線(_)作為標記強調(diào)字詞的符號,將需要加粗+傾斜的文字包圍即可。

刪除線

兩個波浪線~~作為標記強調(diào)字詞的符號,將需要加刪除線的文字包圍即可。

  • 書寫格式
    這是一段普通的文字
    **這是一段要加粗的文字**
    __這是另外一段要加粗的文字__
    *這是一段要傾斜的文字*
    _這是另外一段要傾斜的文字_
    ***這是一段要加粗和傾斜的文字***
    ___這是另外一段要加粗和傾斜的文字___
    ~~這是一段要加刪除線的文字~~
    * 這是一段要傾斜但是 ** 前后都有空白沒有傾斜的文字 *

  • 解析效果

這是一段普通的文字
這是一段要加粗的文字
這是另外一段要加粗的文字
這是一段要傾斜的文字
這是另外一段要傾斜的文字
這是一段要加粗和傾斜的文字
這是另外一段要加粗和傾斜的文字
這是一段要加刪除線的文字

注:如果*或_或~兩邊都有空格的話,他們會被當作普通符號。

6.列表

無序列表

- + *加空格,后跟內(nèi)容。

有序列表

數(shù)字加.,序號與內(nèi)容間要有空格。

  • 書寫格式
    - 我是一個無序列表
    + 我也是
    * 好巧,我也是
    1.我是第一個有序列表
    2.我是第二個有序列表
    3.我是第三個有序列表

  • 解析效果

  • 我是一個無序列表

  • 我也是
  • 好巧,我也是
    1.我是第一個有序列表
    2.我是第二個有序列表
    3.我是第三個有序列表

列表嵌套

上級和下級間敲三個空格即可。

  • 書寫格式
    - 我是一個無序列表
    + 好巧,我也是
    * 神奇,我也是哦
    1.我是第一個有序列表
    - 我是二級無序列表
    2.我是第二個有序列表
    3.我是第三個有序列表
  • 解析效果
  • 我是一個無序列表
  • 好巧,我也是
  • 神奇,我也是哦
    1.我是第一個有序列表
  • 我是二級無序列表
    2.我是第二個有序列表
    3.我是第三個有序列表
注:這里只演示了有序列表嵌套一個無序列表的寫法,其他的嵌套組合也是有效的,可自行測試。

7.表格

  • 書寫格式(表頭與前面內(nèi)容隔一行)
    |表頭|表頭|表頭|
    |:-|:--:|---:|
    |內(nèi)容|內(nèi)容|內(nèi)容|
  • 解析效果
表頭 表頭 表頭
內(nèi)容 內(nèi)容 內(nèi)容
注:第二行元素分隔表頭和內(nèi)容,其中 - 一個以上即可, : 在左即內(nèi)容左對齊,在右即內(nèi)容右對齊,兩邊都有即居中對齊。

8.引用

  • 書寫格式
    >這是第一個引用
    >>這個第二個引用
    >>>這是第三個引用
  • 解析效果

這是第一個引用

這個第二個引用

這是第三個引用

9. 代碼

單行代碼

語法:代碼左右分別一個 `(反引號,鍵盤上波浪線下面的符號)包裹代碼即可。

  • 書寫方式

`var a = 1`

  • 解析效果

var a = 1

代碼塊

語法:代碼左右兩邊分別用三個```包裹代碼塊即可。

  • 書寫格式

```
var a = 1
var b = 2
```

  • 解析效果。
    var a = 1
    var b = 2

代碼高亮

在寫需要展示的代碼時,標明代碼的種類,有的瀏覽器會自動的給代碼加一些顏色

  • 書寫格式
    ```JavaScript
    var a = 1
    var b = 2
    ```

  • 解析效果

    var a = 1
    var b = 2

10.分割線

語法:三個或以上 * 或 - 或 _ 可有分割線效果 。

  • 書寫方式
    ***
    ---
    ___
  • 解析效果



注:使用 --- 作為水平分割線時,要在它的前面空一行,防止 --- 被當成標題標記的表示方式。

11.角標

語法:這里的角標內(nèi)容會被放在文末,點擊角標可以實現(xiàn)跳轉,點擊文末的返回按鈕即可返回角標,使用 [^] 來定義腳注。

  • 書寫格式
    這篇博客是有關MarkDown基本語法的博客[^1] ,希望以后繼續(xù)加油,多寫博客[^2]。
    [^1]:[球丁丁的第一篇學習博客]
    [^2]: [加油加油加油]

  • 解析效果
    這篇博客是有關MarkDown基本語法的博客[1] ,希望以后繼續(xù)加油,多寫博客[2]

  • 文末截圖


    文末顯示的內(nèi)容

12. 其他

反斜杠

有時候我們需要在文章中引用一些符號,為了避免這些符號被當作MarkDown標識符發(fā)生不必要的格式轉化,可以在符號前加 反斜杠\ 來避免。

  • 書寫格式
    \# 我不是一級標題
    \- 我不是無序列表
  • 解析效果

# 我不是一級標題
- 我不是無序列表
MarkDown 支持以下這些符號前面加上 反斜杠 來幫助插入普通的符號(表格來源)

符號 含義
\ 反斜杠
` 反引號
* 星號
_ 底線
{} 大括號
[] 方括號
() 括號
# 警號
+ - 加減號
. 英文句號
! 驚嘆號

最后推薦一個小游戲可以練習MarkDown基本語法http://commonmark.cn/help/tutorial/

參考資料

  1. [球丁丁的第一篇學習博客] ?

  2. [加油加油加油] ?

最后編輯于
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內(nèi)容

  • 歡迎關注微信公眾號:北島向南(id:nanzhouie) GitHub Pages:https://zhouie....
    zhouie閱讀 5,149評論 4 72
  • 文字的發(fā)明和使用使得信息的保存和傳遞有了革命性的飛躍。隨著信息的豐富和傳遞方式的革新,人們對文本提出了新的格式化的...
    haoeric閱讀 7,746評論 1 16
  • (小白入手必讀) 喜歡簡書的朋友,每天看著別人寫的文章,自己也總會有想去寫一些東西的沖動,可是面對簡書的文本編輯格...
    君不器12323閱讀 3,470評論 2 27
  • 勸君莫惜金縷衣,勸君惜取少年時。花開堪折直須折,莫待無花空折枝?!徘锬铩そ鹂|衣 這是一部比預期要沉重的影片,新...
    潘慧敏閱讀 1,189評論 0 7
  • 這幾年來,我一直是家委會成員,認真負責地對待家委會工作,大力支持班級家委會工作。 我利用我的優(yōu)勢,積...
    徐雨恒閱讀 13,709評論 0 0

友情鏈接更多精彩內(nèi)容