markdown基本語法

前言

筆者最近想找一個博客來記載一些web開發方面的知識,偶然發現簡書的體系甚好,并且完美支持富文本和markdown的寫法,所以就準備在簡書扎根啦,正所謂 兵馬未動,糧草先行,在此呢,先記錄一下markdown的基本語法,方面忘記的時候來回顧一下,如此,甚好甚好~

語法介紹

一、標題

標題的實現可以有兩種形式,我們比較常用的是第一種

  1. 使用#號標記
    使用 # 號可表示 1-6 級標題,一級標題對應一個 # 號,二級標題對應兩個 # 號,以此類推。
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
  1. 使用 = 和 - 來標記一級和二級標題
    = 和 - 標記語法格式如下:
我展示的是一級標題
=================

我展示的是二級標題
-----------------

總結:標題這塊語法相對簡單,我這里就不做演示了,大家可以自己試一下

二、字體

Markdown 可以使用以下幾種字體:

*斜體文本*
_斜體文本_
**粗體文本**
__粗體文本__
***粗斜體文本***
___粗斜體文本___

顯示效果如下:


斜體文本
斜體文本
粗體文本
粗體文本
粗斜體文本
粗斜體文本


三、分割線

你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:

***

* * *

*****

- - -

----------

顯示效果如下:






四、刪除線

如果段落上的文字要添加刪除線,只需要在文字的兩端加上兩個波浪線 ~~ 即可,實例如下:

RUNOOB.COM
GOOGLE.COM
~~BAIDU.COM~~

顯示效果如下:

RUNOOB.COM
GOOGLE.COM
BAIDU.COM

五、下劃線

下劃線可以通過 HTML 的 <u> 標簽來實現(好像在簡書不支持):

<u>帶下劃線文本</u>

顯示效果如下:

<u>帶下劃線文本</u>

六、腳注

腳注是對文本的補充說明。Markdown 腳注的格式如下:

[^要注明的文本]

以下實例演示了腳注的用法:

創建腳注格式類似這樣 [^注解]。

[^注解]: 古之立大事者 -- 不惟有超世之才,亦必有堅韌不拔之志!!!

顯示效果如下:

創建腳注格式類似這樣 [1]

七、列表

Markdown 支持有序列表和無序列表。

無序列表使用星號(*)、加號(+)或是減號(-)作為列表標記:

* 第一項
* 第二項
* 第三項

+ 第一項
+ 第二項
+ 第三項


- 第一項
- 第二項
- 第三項

顯示效果如下:

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

有序列表使用數字并加上 . 號來表示,如:

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

顯示效果如下:

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

列表嵌套:列表嵌套只需在子列表中的選項添加四個空格即可:

1. 第一項:
    - 第一項嵌套的第一個元素
    - 第一項嵌套的第二個元素
2. 第二項:
    - 第二項嵌套的第一個元素
    - 第二項嵌套的第二個元素

顯示效果如下:

  1. 第一項:
    • 第一項嵌套的第一個元素
    • 第一項嵌套的第二個元素
  2. 第二項:
    • 第二項嵌套的第一個元素
    • 第二項嵌套的第二個元素
八、鏈接

鏈接使用方法如下:

[鏈接名稱](鏈接地址)

或者

<鏈接地址>

例如:

這是一個鏈接 [百度](https://www.baiducom)

顯示效果如下:

這是一個鏈接 百度

直接使用鏈接地址:

<https://www.baiducom>

顯示效果如下:

https://www.baiducom

鏈接也可以用變量來代替,文檔末尾附帶變量地址:

這個鏈接用 1 作為網址變量 [Google][1]
這個鏈接用 du 作為網址變量 [baidu][2]
然后在文檔的結尾為變量賦值(網址)

顯示效果如下:

這個鏈接用 1 作為網址變量 Google
這個鏈接用2 作為網址變量 baidu
然后在文檔的結尾為變量賦值(網址)

九、圖片

Markdown 圖片語法格式如下:

![alt 屬性文本](圖片地址)

![alt 屬性文本](圖片地址 "可選標題")
  • 開頭一個感嘆號 !
  • 接著一個方括號,里面放上圖片的替代文字
  • 接著一個普通括號,里面放上圖片的網址,最后還可以用引號包住并加上選擇性的 'title' 屬性的文字。

使用實例:

![貓咪](https://upload-images.jianshu.io/upload_images/21292023-95d4d4da779d2ec1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

![狗狗](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1581510620269&di=1834d9a7fe222e90186c9bfde76adb7a&imgtype=0&src=http%3A%2F%2Fimg.juimg.com%2Ftuku%2Fyulantu%2F121005%2F219049-1210051Q25899.jpg "狗子")

顯示結果如下:

貓咪
狗狗

當然,你也可以像網址那樣對圖片網址使用變量:

這個鏈接用 1 作為網址變量! [狗子][1].
然后在文檔的結尾為變量賦值(網址)

[1]: https://upload-images.jianshu.io/upload_images/21292023-95d4d4da779d2ec1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240

顯示結果如下:

這個鏈接用 1 作為網址變量
狗子

.
然后在文檔的結尾為變量賦值(網址)

Markdown 還沒有辦法指定圖片的高度與寬度,如果你需要的話,你可以使用普通的 <img> 標簽(有的不支持此功能,比如簡書,所以這里不再做示例展示)。

<img src="https://upload-images.jianshu.io/upload_images/21292023-95d4d4da779d2ec1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240">

十、代碼

如果是段落上的一個函數或片段的代碼可以用反引號把它包起來(`),例如:

`console.log()` 函數

顯示效果如下:

console.log() 函數

代碼區塊:用 ``` 包裹一段代碼,并指定一種語言(也可以不指定):

    ```javascript
     $(document).ready(function () {
       alert('RUNOOB');
     });
    ```

顯示效果如下:

$(document).ready(function () {
    alert('RUNOOB');
});
十一、表格

Markdown 制作表格使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行。

語法格式如下:

|  表頭   | 表頭  |
|  ----  | ----  |
| 單元格  | 單元格 |
| 單元格  | 單元格 |

顯示效果如下:

表頭 表頭
單元格 單元格
單元格 單元格

我們可以設置表格的對齊方式:

  • -: 設置內容和標題欄居右對齊。
  • :- 設置內容和標題欄居左對齊。
  • :-: 設置內容和標題欄居中對齊。
    實例如下:
| 左對齊 | 右對齊 | 居中對齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |

顯示效果如下:

左對齊 右對齊 居中對齊
單元格 單元格 單元格
單元格 單元格 單元格
十二、區塊

Markdown 區塊引用是在段落開頭使用 > 符號 ,然后后面緊跟一個空格符號:

> 區塊引用
> 簡書
> 簡述你的夢想

顯示效果如下:

區塊引用
簡書
簡述你的夢想

另外區塊是可以嵌套的,一個 > 符號是最外層,兩個 > 符號是第一層嵌套,以此類推:

> 最外層
> > 第一層嵌套
> > > 第二層嵌套

顯示效果如下:

最外層

第一層嵌套

第二層嵌套

區塊中使用列表實例如下:

> 區塊中使用列表
> 1. 第一項
> 2. 第二項
> + 第一項
> + 第二項
> + 第三項

顯示效果如下:

區塊中使用列表

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

如果要在列表項目內放進區塊,那么就需要在 > 前添加四個空格的縮進。

區塊中使用列表實例如下:

* 第一項
    > 菜鳥教程
    > 學的不僅是技術更是夢想
* 第二項

顯示效果如下:

  • 第一項

    菜鳥教程
    學的不僅是技術更是夢想

  • 第二項
十三、高級技巧

1、支持的 HTML 元素

不在 Markdown 涵蓋范圍之內的標簽,都可以直接在文檔里面用 HTML 撰寫。

目前支持的 HTML 元素有:<kbd> <b> <i> <em>
等 ,如:

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦

顯示效果如下:

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦

2、轉義

Markdown 使用了很多特殊符號來表示特定的意義,如果需要顯示特定的符號則需要使用轉義字符,Markdown 使用反斜杠轉義特殊字符:

**文本加粗** 
\*\* 正常顯示星號 \*\*

顯示效果如下:

文本加粗
** 正常顯示星號 **

Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:

\   反斜線
`   反引號
*   星號
_   下劃線
{}  花括號
[]  方括號
()  小括號
#   井字號
+   加號
-   減號
.   英文句點
!   感嘆號

結語:以上就是我們比較會經常用到的語法啦,當然了,還有很多其他的功能,但是并不會很常用,比如插入公式,寫流程圖等等,大家有興趣的可以自行研究一下,本片到這里就結束了,歡迎大家關注和收藏哦~


  1. 古之立大事者 -- 不惟有超世之才,亦必有堅韌不拔之志!!! ?

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容