前言
筆者最近想找一個(gè)博客來記載一些web開發(fā)方面的知識(shí),偶然發(fā)現(xiàn)簡(jiǎn)書的體系甚好,并且完美支持富文本和markdown的寫法昌屉,所以就準(zhǔn)備在簡(jiǎn)書扎根啦,正所謂 兵馬未動(dòng)茵瀑,糧草先行间驮,在此呢,先記錄一下markdown的基本語法马昨,方面忘記的時(shí)候來回顧一下竞帽,如此,甚好甚好~
語法介紹
一鸿捧、標(biāo)題
標(biāo)題的實(shí)現(xiàn)可以有兩種形式屹篓,我們比較常用的是第一種
- 使用#號(hào)標(biāo)記
使用 # 號(hào)可表示 1-6 級(jí)標(biāo)題,一級(jí)標(biāo)題對(duì)應(yīng)一個(gè) # 號(hào)匙奴,二級(jí)標(biāo)題對(duì)應(yīng)兩個(gè) # 號(hào)堆巧,以此類推。
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題
- 使用 = 和 - 來標(biāo)記一級(jí)和二級(jí)標(biāo)題
= 和 - 標(biāo)記語法格式如下:
我展示的是一級(jí)標(biāo)題
=================
我展示的是二級(jí)標(biāo)題
-----------------
總結(jié):標(biāo)題這塊語法相對(duì)簡(jiǎn)單,我這里就不做演示了恳邀,大家可以自己試一下
二懦冰、字體
Markdown 可以使用以下幾種字體:
*斜體文本*
_斜體文本_
**粗體文本**
__粗體文本__
***粗斜體文本***
___粗斜體文本___
顯示效果如下:
斜體文本
斜體文本
粗體文本
粗體文本
粗斜體文本
粗斜體文本
三、分割線
你可以在一行中用三個(gè)以上的星號(hào)谣沸、減號(hào)刷钢、底線來建立一個(gè)分隔線,行內(nèi)不能有其他東西乳附。你也可以在星號(hào)或是減號(hào)中間插入空格内地。下面每種寫法都可以建立分隔線:
***
* * *
*****
- - -
----------
顯示效果如下:
四、刪除線
如果段落上的文字要添加刪除線赋除,只需要在文字的兩端加上兩個(gè)波浪線 ~~ 即可阱缓,實(shí)例如下:
RUNOOB.COM
GOOGLE.COM
~~BAIDU.COM~~
顯示效果如下:
RUNOOB.COM
GOOGLE.COM
BAIDU.COM
五、下劃線
下劃線可以通過 HTML 的 <u> 標(biāo)簽來實(shí)現(xiàn)(好像在簡(jiǎn)書不支持):
<u>帶下劃線文本</u>
顯示效果如下:
<u>帶下劃線文本</u>
六举农、腳注
腳注是對(duì)文本的補(bǔ)充說明荆针。Markdown 腳注的格式如下:
[^要注明的文本]
以下實(shí)例演示了腳注的用法:
創(chuàng)建腳注格式類似這樣 [^注解]。
[^注解]: 古之立大事者 -- 不惟有超世之才颁糟,亦必有堅(jiān)韌不拔之志:奖场!棱貌!
顯示效果如下:
創(chuàng)建腳注格式類似這樣 [1]玖媚。
七、列表
Markdown 支持有序列表和無序列表婚脱。
無序列表使用星號(hào)(*)今魔、加號(hào)(+)或是減號(hào)(-)作為列表標(biāo)記:
* 第一項(xiàng)
* 第二項(xiàng)
* 第三項(xiàng)
+ 第一項(xiàng)
+ 第二項(xiàng)
+ 第三項(xiàng)
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
顯示效果如下:
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
有序列表使用數(shù)字并加上 . 號(hào)來表示,如:
1. 第一項(xiàng)
2. 第二項(xiàng)
3. 第三項(xiàng)
顯示效果如下:
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
列表嵌套:列表嵌套只需在子列表中的選項(xiàng)添加四個(gè)空格即可:
1. 第一項(xiàng):
- 第一項(xiàng)嵌套的第一個(gè)元素
- 第一項(xiàng)嵌套的第二個(gè)元素
2. 第二項(xiàng):
- 第二項(xiàng)嵌套的第一個(gè)元素
- 第二項(xiàng)嵌套的第二個(gè)元素
顯示效果如下:
- 第一項(xiàng):
- 第一項(xiàng)嵌套的第一個(gè)元素
- 第一項(xiàng)嵌套的第二個(gè)元素
- 第二項(xiàng):
- 第二項(xiàng)嵌套的第一個(gè)元素
- 第二項(xiàng)嵌套的第二個(gè)元素
八障贸、鏈接
鏈接使用方法如下:
[鏈接名稱](鏈接地址)
或者
<鏈接地址>
例如:
這是一個(gè)鏈接 [百度](https://www.baiducom)
顯示效果如下:
這是一個(gè)鏈接 百度
直接使用鏈接地址:
<https://www.baiducom>
顯示效果如下:
鏈接也可以用變量來代替错森,文檔末尾附帶變量地址:
這個(gè)鏈接用 1 作為網(wǎng)址變量 [Google][1]
這個(gè)鏈接用 du 作為網(wǎng)址變量 [baidu][2]
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)
顯示效果如下:
這個(gè)鏈接用 1 作為網(wǎng)址變量 Google
這個(gè)鏈接用2 作為網(wǎng)址變量 baidu
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)
九、圖片
Markdown 圖片語法格式如下:
![alt 屬性文本](圖片地址)
![alt 屬性文本](圖片地址 "可選標(biāo)題")
- 開頭一個(gè)感嘆號(hào) !
- 接著一個(gè)方括號(hào)篮洁,里面放上圖片的替代文字
- 接著一個(gè)普通括號(hào)问词,里面放上圖片的網(wǎng)址,最后還可以用引號(hào)包住并加上選擇性的 'title' 屬性的文字嘀粱。
使用實(shí)例:
![貓咪](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 "狗子")
顯示結(jié)果如下:
當(dāng)然,你也可以像網(wǎng)址那樣對(duì)圖片網(wǎng)址使用變量:
這個(gè)鏈接用 1 作為網(wǎng)址變量! [狗子][1].
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)
[1]: https://upload-images.jianshu.io/upload_images/21292023-95d4d4da779d2ec1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
顯示結(jié)果如下:
這個(gè)鏈接用 1 作為網(wǎng)址變量.
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)
Markdown 還沒有辦法指定圖片的高度與寬度辰狡,如果你需要的話锋叨,你可以使用普通的 <img> 標(biāo)簽(有的不支持此功能,比如簡(jiǎn)書,所以這里不再做示例展示)宛篇。
<img src="https://upload-images.jianshu.io/upload_images/21292023-95d4d4da779d2ec1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240">
十娃磺、代碼
如果是段落上的一個(gè)函數(shù)或片段的代碼可以用反引號(hào)把它包起來(`),例如:
`console.log()` 函數(shù)
顯示效果如下:
console.log()
函數(shù)
代碼區(qū)塊:用 ``` 包裹一段代碼叫倍,并指定一種語言(也可以不指定):
```javascript
$(document).ready(function () {
alert('RUNOOB');
});
```
顯示效果如下:
$(document).ready(function () {
alert('RUNOOB');
});
十一偷卧、表格
Markdown 制作表格使用 | 來分隔不同的單元格豺瘤,使用 - 來分隔表頭和其他行。
語法格式如下:
| 表頭 | 表頭 |
| ---- | ---- |
| 單元格 | 單元格 |
| 單元格 | 單元格 |
顯示效果如下:
表頭 | 表頭 |
---|---|
單元格 | 單元格 |
單元格 | 單元格 |
我們可以設(shè)置表格的對(duì)齊方式:
- -: 設(shè)置內(nèi)容和標(biāo)題欄居右對(duì)齊听诸。
- :- 設(shè)置內(nèi)容和標(biāo)題欄居左對(duì)齊坐求。
-
:-: 設(shè)置內(nèi)容和標(biāo)題欄居中對(duì)齊。
實(shí)例如下:
| 左對(duì)齊 | 右對(duì)齊 | 居中對(duì)齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |
顯示效果如下:
左對(duì)齊 | 右對(duì)齊 | 居中對(duì)齊 |
---|---|---|
單元格 | 單元格 | 單元格 |
單元格 | 單元格 | 單元格 |
十二晌梨、區(qū)塊
Markdown 區(qū)塊引用是在段落開頭使用 > 符號(hào) 桥嗤,然后后面緊跟一個(gè)空格符號(hào):
> 區(qū)塊引用
> 簡(jiǎn)書
> 簡(jiǎn)述你的夢(mèng)想
顯示效果如下:
區(qū)塊引用
簡(jiǎn)書
簡(jiǎn)述你的夢(mèng)想
另外區(qū)塊是可以嵌套的,一個(gè) > 符號(hào)是最外層仔蝌,兩個(gè) > 符號(hào)是第一層嵌套泛领,以此類推:
> 最外層
> > 第一層嵌套
> > > 第二層嵌套
顯示效果如下:
最外層
第一層嵌套
第二層嵌套
區(qū)塊中使用列表實(shí)例如下:
> 區(qū)塊中使用列表
> 1. 第一項(xiàng)
> 2. 第二項(xiàng)
> + 第一項(xiàng)
> + 第二項(xiàng)
> + 第三項(xiàng)
顯示效果如下:
區(qū)塊中使用列表
- 第一項(xiàng)
- 第二項(xiàng)
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
如果要在列表項(xiàng)目?jī)?nèi)放進(jìn)區(qū)塊,那么就需要在 > 前添加四個(gè)空格的縮進(jìn)敛惊。
區(qū)塊中使用列表實(shí)例如下:
* 第一項(xiàng)
> 菜鳥教程
> 學(xué)的不僅是技術(shù)更是夢(mèng)想
* 第二項(xiàng)
顯示效果如下:
- 第一項(xiàng)
菜鳥教程
學(xué)的不僅是技術(shù)更是夢(mèng)想 - 第二項(xiàng)
十三渊鞋、高級(jí)技巧
1、支持的 HTML 元素
不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽瞧挤,都可以直接在文檔里面用 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皿伺、轉(zhuǎn)義
Markdown 使用了很多特殊符號(hào)來表示特定的意義员辩,如果需要顯示特定的符號(hào)則需要使用轉(zhuǎn)義字符,Markdown 使用反斜杠轉(zhuǎn)義特殊字符:
**文本加粗**
\*\* 正常顯示星號(hào) \*\*
顯示效果如下:
文本加粗
** 正常顯示星號(hào) **
Markdown 支持以下這些符號(hào)前面加上反斜杠來幫助插入普通的符號(hào):
\ 反斜線
` 反引號(hào)
* 星號(hào)
_ 下劃線
{} 花括號(hào)
[] 方括號(hào)
() 小括號(hào)
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 感嘆號(hào)
結(jié)語:以上就是我們比較會(huì)經(jīng)常用到的語法啦鸵鸥,當(dāng)然了奠滑,還有很多其他的功能,但是并不會(huì)很常用妒穴,比如插入公式宋税,寫流程圖等等,大家有興趣的可以自行研究一下讼油,本片到這里就結(jié)束了杰赛,歡迎大家關(guān)注和收藏哦~
-
古之立大事者 -- 不惟有超世之才,亦必有堅(jiān)韌不拔之志0ā7ν汀! ?