MarkDown 基本語法

MarkDown 基本語法

MarkDown 是一種純文本格式的標記語言,通過簡單的標記語法,可以使普通的文本具有一定的格式。它是將文檔以 HTML 格式發(fā)布,最終的顯示效果取決于前端的渲染。MarkDown 也可以理解為將以 MarkDown 語法編寫的純文本轉(zhuǎn)換成 HTML 的工具,最終在網(wǎng)頁顯示 HTML 內(nèi)容。

目錄


一、標題

使用 # 表示 1~6 級標題

標準語法是在 # 后跟一個空格,1 個 # 表示一級標題,2 個 ## 表示二級標題

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

效果如下:

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

一級標題和二級標題還可以通過 ===--- 符號標記,標記方式如下:

一級標題
===
二級標題
---

效果如下:

一級標題

二級標題

二、目錄

目錄使用 [顯示文字](#段落中的標題) 的形式鏈接到當前文檔的特定位置,如下寫法可連接到本文檔的 九、列表 位置處,寫法如下

[鏈接到第九章](#九、列表)

效果如下
鏈接到第九章

三、段落

需要使用空行分段,即段落的前后需要是空行,只回車換行在顯示效果中是沒有換行效果的。
若想在一個段落內(nèi)換行,需要在行尾加上至少兩個空格,再回車換行。
若想在特定位置加入空行,可以在使用 <br> 表示空行,如下所示:

直接回車換行
不能實現(xiàn)換行功能
行末加兩個空格
實現(xiàn)換行
使用<br>表示換行<br><br>換兩行

效果如下:

直接回車換行
不能實現(xiàn)換行功能
行末加兩個空格
實現(xiàn)換行
使用
表示換行

換兩行

四、字體

  • 粗體
    使用 **粗體文字** 的形式,在要加粗的文字兩端使用兩個 ** 包裹起來

    粗體文字

  • 斜體
    使用 *斜體文字* 的形式,在文字的兩端使用 * 包裹起來

    斜體文字

  • 刪除線
    使用 ~~刪除線文字~~ 的形式,在文字的兩端使用 ~~ 包裹起來

    刪除線文字

以上方式還可以組合使用,如下所示

***加粗的斜體文字***
~~*斜體帶刪除線文字*~~
~~**加粗帶刪除線文字**~~
~~***加粗的斜體帶刪除線文字***~~

效果如下

加粗的斜體文字
斜體帶刪除線文字
加粗帶刪除線文字
加粗的斜體帶刪除線文字

五、引用

引用在行首加 > 符號即可,還可嵌套引用,輸入多個 > 即可,如下所示

> 引用
>> 嵌套引用
>>> 多層嵌套引用

效果如下

引用

嵌套引用

多層嵌套引用

六、分割線

分割線使用三個或三個以上的 -* 符號

---
***

效果如下



注意,在使用 --- 符號時,上一行應(yīng)當是空行,否則其會將上一行解釋為二級標題,而不是分割線

七、超鏈接

超鏈接使用 [超鏈接名](超鏈接地址 "超鏈接標題") 的語法,其中 "超鏈接標題" 可寫可不寫,其效果為鼠標懸停時顯示的文字

[百度](https://www.baidu.com "百度網(wǎng)址")

效果為
百度

八、圖片

插入圖片的語法和插入超鏈接類似,只需在鏈接前面加上 ! 即可,語法如下

![圖片alt](圖片地址 "圖片title")

其中圖片地址可以是本地路徑,也可以是網(wǎng)絡(luò)圖片

九、列表

  • 無序列表
    使用 + 、-、或 * 標記無需列表,如下寫法

    + 第一項
    - 第二項
    * 第三項

    效果如下

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

還可以通過寫 <li> 的形式標記列表項,如下寫法

<li> 項一
<li> 項二

效果為(部分解釋器可能不支持)

<li> 項一
<li> 項二

  • 有序列表
    使用 數(shù)字. 來表示,一般列表的第一個數(shù)字為起始編號數(shù)字,后面會自動加一排序,如下寫法

    1. 有序第一行
    2. 有序第二行
    3. 有序第三行

    2. 有序第一行
    8. 有序第二行
    1. 有序第三行

    效果如下

    1. 有序第一行
    2. 有序第二行
    3. 有序第三行
    1. 有序第一行
    2. 有序第二行
    3. 有序第三行

還可以通過寫 <ol start="1"><li>……<li> 的形式寫有序列表,如下寫法(部分解釋器可能不支持):

<ol><li> 有序項一
<li> 有序項二

<ol start="5"><li> 有序項一
<li> 有序項二

效果為:

<ol><li> 有序項一
<li> 有序項二

<ol start="5"><li> 有序項一
<li> 有序項二

注意:在列表中,若想實現(xiàn)縮進,即一個列表項下想把較多的內(nèi)容都縮進到列表項后面,需要在換行后的內(nèi)容的行首加3個空格

列表嵌套
列表嵌套需要在下一級列表前輸入3個空格,如下寫法(此處用 s 表示空格)

1. 一級有序列表
sss* 二級無需列表

效果如下

  1. 一級有序列表
    • 二級無需列表

十、表格

表格語法如下

|表頭1|表頭2|表頭3|
|:---|:---:|----:|
|內(nèi)容|內(nèi)容|內(nèi)容|
|a|b|c|

顯示效果如下

表頭1 表頭2 表頭3
內(nèi)容 內(nèi)容 內(nèi)容
a b c

其中,最前面一列和最后一列的 | 可以省略不寫,第二行中的 : 指示此列的對齊方式,寫在左面為左對齊,寫在右面為右對齊,寫在兩端為居中

表格中寫列表時,可以采用第九章中描述的 <li><ol><li> 標記的形式實現(xiàn),如下寫法:

|表頭1|表頭2|表頭3| 
|:---|:---:|----|
|內(nèi)容|內(nèi)容|內(nèi)容描述,下面是列表<br><li> 選項一 <li> 選項二|
|a|b|比較長的內(nèi)容,下面是有序列表<br><ol start="1"><li> 有序選項一 <li> 有序選項二|

顯示效果為(部分解釋器可能不支持):

表頭1 表頭2 表頭3
內(nèi)容 內(nèi)容 內(nèi)容描述,下面是列表
<li> 選項一 <li> 選項二
a b 比較長的內(nèi)容,下面是有序列表
<ol start="1"><li> 有序選項一 <li> 有序選項二

十一、其它符號

  • 轉(zhuǎn)義符號 \
    轉(zhuǎn)義符號 \ 用于輸出特殊符號

  • 代碼標識符號 '`'
    代碼標識符號 ' ` ' 用于標記代碼,行內(nèi)使用時,使用 `代碼` 完成行內(nèi)標記,如: 代碼
    當不使用行內(nèi)代碼,而是標記代碼段時,在代碼段的前后用 ``` 包裹起來,如:

    ```
    int add(int a, int b)
    {
    \qquadreturn a + b;
    }
    ```

    效果為

    int add(int a, int b)
    {
        return a + b;
    }
    

    可以手動指定代碼的語言類型,語法為在第一個 '```' 后寫上語言名稱,如上所示代碼寫成下面的形式:

    ```cpp
    int add(int a, int b)
    {
    \qquadreturn a + b;
    }
    ```

    效果為:

    int add(int a, int b)
    {
        return a + b;
    }
    
  • 數(shù)學公式轉(zhuǎn)義符號 $

    數(shù)學公式轉(zhuǎn)義符號用于轉(zhuǎn)義數(shù)學公式,當使用行內(nèi)公式時,使用一個 $ 符號 包裹公式,使用單獨一行的公式時,使用 $$ 包裹公式,如下:

    行內(nèi)公式:$f(x)=ax+b$
    $$E=mc^2$$

    效果為:

    行內(nèi)公式:f(x)=ax+b
    E=mc^2

    關(guān)于數(shù)學公式的具體用法請參見:


雷震西山 2019年10月20日

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

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

  • HTML5 File API 在 HTML5 的 input 標簽中,新增了一個 type=file 屬性的表單控...
    多云轉(zhuǎn)晴i閱讀 366評論 0 1
  • 【標題】認知不夠,努力白費 【字數(shù)】530字 【正文】 2019年10月1日,是新中國成立七十周年,隨處可見的紅旗...
    徐徐成峰閱讀 86評論 0 0
  • 2 019年10月19日成長日記 商洛彤媽誦讀《易經(jīng)》、《中庸》、《唐詩三百首》。 卡頓中的手機:金老師教我們要及...
    商洛彤媽閱讀 205評論 1 0
  • 我之前寫過一篇文章《變》,從講自己的體重變大而引出的一系列生活中的問題,之后要如何如何改變。其中我說自己早晨起不來...
    非蘇力閱讀 774評論 1 0
  • 昨晚臨時決定帶上小妞去醫(yī)院看奶奶。 自從國慶節(jié)奶奶住了院,她就一直沒能見到奶奶。 作為從小被奶奶帶大的娃,妞兒時不...
    山間竹音閱讀 233評論 0 0

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