markdown的使用

標(biāo)題

Markdown 中,只需要在文本前面加上“#”,就會(huì)被認(rèn)為是加了一個(gè)標(biāo)題。同理,你還可以增加二級(jí)、三級(jí)、四級(jí)、五級(jí)標(biāo)題和六級(jí)標(biāo)題,只需要增加“#” 即可。例如:

# 一級(jí)標(biāo)題

## 二級(jí)標(biāo)題

### 三級(jí)標(biāo)題

#### 四級(jí)標(biāo)題

##### 五級(jí)標(biāo)題

###### 六級(jí)標(biāo)題

顯示效果:

一級(jí)標(biāo)題

二級(jí)標(biāo)題

三級(jí)標(biāo)題

四級(jí)標(biāo)題

五級(jí)標(biāo)題
六級(jí)標(biāo)題

段落

換行

在markdown中,直接換行是沒用的,比如:


所有的結(jié)局都已寫好
所有的淚水也都啟程

寫好的格式是這樣,但是有時(shí)會(huì)顯示成


所有的結(jié)局都已寫好所有的淚水也都啟程

也就是一排顯示,這時(shí)只需要在倆行中間敲一下enter,即可換行,但是此時(shí)倆行中間間距略微偏多,這時(shí)可以在第一行末尾,敲倆個(gè)空格,也可實(shí)現(xiàn)效果。

縮進(jìn)

在markdown中縮進(jìn):

  • 半方大的空白 或 
  • 全方大的空白 或 
  • 不斷行的空白格 或 

列表

當(dāng)你要羅列一些內(nèi)容時(shí),列表是很有用的工具。為了說明哪些條目屬于這個(gè)列表,我們需要引入“項(xiàng)目標(biāo)記”。

列表項(xiàng)目標(biāo)記通常放在段落開頭,后面要跟著一個(gè)空格。列表的各個(gè)條目之間可以不留空行。

無序列表

若列表中的條目沒有特定順序時(shí),可以使用 無序列表。加號(hào)“+”或減號(hào)“-”都可以作為列表標(biāo)記,后面要跟一個(gè)空格。例如:

+ 蘋果

+ 橘子

+ 梨子

或者:

- 蘋果

- 橘子

- 梨子

顯示效果:

  • 蘋果

  • 橘子

  • 梨子

有序列表

若想在段落前加上數(shù)字序號(hào),就需要用到有序列表了。使用數(shù)字、一個(gè)英文句號(hào)和一個(gè)空格即可。例如:

1. 蘋果

2. 橘子

3. 梨子

顯示效果:

  1. 蘋果

  2. 橘子

  3. 梨子

多級(jí)列表

圖片

Markdown 中可以插入圖片,只需要感嘆號(hào)、方括號(hào)和圓括號(hào)即可。例如:

![text](Picture address)

一個(gè)英文感嘆號(hào) “!” 后緊跟方括號(hào),里面可以寫這張圖片的說明;再緊跟一對(duì)圓括號(hào),里面寫這張圖片的網(wǎng)址。例如:

![一只可愛的狗狗](https://upload-images.jianshu.io/upload_images/12865607-9d166ae9050e9f8e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

顯示效果:

一只可愛的狗狗

當(dāng)然,如果你只是想單純上傳一張圖片,不想有文字描述,把文字去掉就可以了:

![](https://upload-images.jianshu.io/upload_images/12865607-9d166ae9050e9f8e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

顯示效果:


鏈接

在文檔中插入連接的語法和插入圖片的語法很像,只是少了最前面的英文感嘆號(hào)"!"。

在方括號(hào)寫下鏈接文字,圓括號(hào)寫下網(wǎng)址即可。

外部鏈接

[這是簡書的首頁](http://www.itdecent.cn/)

顯示效果:

這是簡書的首頁

內(nèi)部鏈接1

鏈接到倉庫中(github)的其他文件:
[demo1](demo1.md)

顯示效果:

demo1
點(diǎn)擊的話會(huì)跳轉(zhuǎn)到demo1.md文件

內(nèi)部鏈接2

鏈接到本文檔的其他部分(類似于html的錨點(diǎn))

[代碼塊 demo](demo2.md#代碼塊-demo)

效果:
代碼塊 demo

引用式鏈接

這個(gè)鏈接就是在文檔某處(一般是文檔尾部),定義好,用的地方直接使用:
<!--下面是本文檔中可能用到的鏈接-->
[簡書]:http://www.itdecent.cn

使用時(shí),直接書寫 “[百度]” 即可實(shí)現(xiàn)鏈接效果


強(qiáng)調(diào)

在Markdown中,可以使用 * 和 _ 來表示斜體和加粗。需要注意的是,“_”是下劃線而非減號(hào)“-”。

斜體

在需要斜體的文本左右各加一個(gè)“*”或“_” ,例如:

*所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。*
_所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。_

顯示效果:

所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。

加粗

在需要加粗的文本左右各加兩個(gè)“*”或“_” ,例如:

**所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。**
__所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。__

顯示效果:

所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。

斜體并加粗

在需要斜體并加粗的文本左右各加三個(gè)“*”或“_” ,例如:

***所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。***
___所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。___

顯示效果:

所謂美好的心靈,就是能體貼萬物的心,能溫柔對(duì)待一草一木的心靈。

刪除線

在文字倆旁各加2個(gè) “~” 即可實(shí)現(xiàn)刪除線的效果:

~~¥199.00~~

顯示效果:

¥199.00


引用

可以使用">" 標(biāo)記來引用其他人的言論、書籍或報(bào)紙的內(nèi)容。只需要在段落的第一行最前面加上 > 即可,例如:

> 青春不是玫瑰,青春是伏特加酒,看起來不怎么樣,喝光的時(shí)候,才知道它的后勁滿強(qiáng)。 —— 林清玄 《你心柔軟,卻有力量》

顯示效果:

青春不是玫瑰,青春是伏特加酒,看起來不怎么樣,喝光的時(shí)候,才知道它的后勁滿強(qiáng)。 ——林清玄 《你心柔軟,卻有力量》

在引用的區(qū)域內(nèi),也可以使用其他的 Markdown 語法,包括標(biāo)題、列表等,例如:

> *青春不是玫瑰,青春是伏特加酒,看起來不怎么樣,喝光的時(shí)候,才知道它的后勁滿強(qiáng)。* ——林清玄 《你心柔軟,卻有力量》

顯示效果:

青春不是玫瑰,青春是伏特加酒,看起來不怎么樣,喝光的時(shí)候,才知道它的后勁滿強(qiáng)。 ——林清玄 《你心柔軟,卻有力量》


分割線

在 Markdown 中,可以用分隔線來將內(nèi)容分成不同區(qū)域。
這里有三種寫法,三個(gè)“-”、三個(gè)“*”、三個(gè)“_”,都可實(shí)現(xiàn)分割線的效果:

  • ---
  • ***
  • ___

顯示效果都是:


簡書中編輯代碼

在markdown中編輯代碼段,分為塊式代碼和行內(nèi)代碼

塊式代碼

可以切換英文輸入法,開頭和結(jié)尾各打三個(gè) “ ``` ”,即可,例如:

```
let add = ( ...val )=>{ // 不定參數(shù)求和
var result = 0;
for( var i = 0; i < val.length; i++ ){
result += val[i];
}
return result;
}
console.log( add( 100, 200 ) ); // 300
```

顯示效果:

let add = ( ...val )=>{     // 不定參數(shù)求和
    let result = 0;
    for( let i = 0; i < val.length; i++ ){
        result += val[i];
    }
    return result;
}
console.log( add( 100, 200 ) );     // 300
行內(nèi)代碼

代碼的開頭和結(jié)尾各打一個(gè) "`" 即可:

我們?nèi)绻跒g覽器中彈出信息,可以使用`alert( " hello " )`。

效果:

我們?nèi)绻跒g覽器中彈出信息,可以使用alert( " hello " )

表格

表格有時(shí)是挺有用的,這里講解一下,一個(gè)基礎(chǔ)的表格實(shí)現(xiàn)方式:

| 姓名 | 年齡 | 性別 |
| ----- | ----- | ----- |
| tom | 23 | 男 |
| jack | 18 | 男 |
| alice | 22 | 女 |

效果:

姓名 年齡 性別
tom 23
jack 18
alice 22

這里可以定義表格的對(duì)齊方式,分別是居左對(duì)齊(默認(rèn))、居中對(duì)齊、居右對(duì)齊,實(shí)現(xiàn)方式就是:

| 姓名 | 年齡 | 性別 |
| :----- | :-----: | -----: |
| tom | 23 | 男 |
| jack | 18 | 男 |
| alice | 22 | 女 |

也就是在不同的位置加冒號(hào),效果:

姓名 年齡 性別
tom 23
jack 18
alice 22

表情

經(jīng)測(cè)試,github是支持添加emoji表情的,輸入不同的符號(hào)碼(倆個(gè)冒號(hào)包圍的字符),可以顯示出不同的表情,比如笑臉:
:smile:
以下是部分表情:


復(fù)雜場(chǎng)景的實(shí)現(xiàn)

圖片鏈接

一張圖片鏈接到百度
[![](https://www.baidu.com/img/bd_logo1.png)](https://www.baidu.com)
效果:

混合強(qiáng)調(diào)樣式
  • ***加粗傾斜***
  • **~~加粗刪除~~**
  • ***~~加粗傾斜刪除~~***

效果:

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

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

  • 1、定義: Markdown 是一種輕量級(jí)標(biāo)記語言,創(chuàng)始人為約翰·格魯伯(英語:John Gruber)。它允許人...
    零一_fb4d閱讀 631評(píng)論 0 0
  • 非原創(chuàng),只是為了方便學(xué)習(xí),原文地址http://www.itdecent.cn/p/q81RER 標(biāo)題 這是最為...
    yzbkaka閱讀 267評(píng)論 0 0
  • 寫文的時(shí)候弄不清用法,看看下右上設(shè)置里的語法參也不是很明白,便自己學(xué)習(xí)了下,下面是總結(jié),建議收藏。 圖片發(fā)自簡書A...
    林露如雨閱讀 1,099評(píng)論 6 11
  • Markdown 是什么 Markdown 是一種輕量級(jí)標(biāo)記語言,創(chuàng)始人為 John Gruber。它允許人們“使...
    onizuka_jp閱讀 491評(píng)論 0 0
  • 1.怎么用標(biāo)題 只需要在文本前面加上#即可,同理、你還可以增加二級(jí)標(biāo)題、三級(jí)標(biāo)題、四級(jí)標(biāo)題、五級(jí)標(biāo)題和六級(jí)標(biāo)題,總...
    淡然7698閱讀 478評(píng)論 0 1

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