markdown的使用

標題

Markdown 中,只需要在文本前面加上“#”,就會被認為是加了一個標題。同理,你還可以增加二級、三級、四級、五級標題和六級標題,只需要增加“#” 即可。例如:

# 一級標題

## 二級標題

### 三級標題

#### 四級標題

##### 五級標題

###### 六級標題

顯示效果:

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

段落

換行

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


所有的結局都已寫好
所有的淚水也都啟程

寫好的格式是這樣,但是有時會顯示成


所有的結局都已寫好所有的淚水也都啟程

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

縮進

在markdown中縮進:

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

列表

當你要羅列一些內容時,列表是很有用的工具。為了說明哪些條目屬于這個列表,我們需要引入“項目標記”。

列表項目標記通常放在段落開頭,后面要跟著一個空格。列表的各個條目之間可以不留空行。

無序列表

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

+ 蘋果

+ 橘子

+ 梨子

或者:

- 蘋果

- 橘子

- 梨子

顯示效果:

  • 蘋果

  • 橘子

  • 梨子

有序列表

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

1. 蘋果

2. 橘子

3. 梨子

顯示效果:

  1. 蘋果

  2. 橘子

  3. 梨子

多級列表

圖片

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

![text](Picture address)

一個英文感嘆號 “!” 后緊跟方括號,里面可以寫這張圖片的說明;再緊跟一對圓括號,里面寫這張圖片的網址。例如:

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

顯示效果:

一只可愛的狗狗

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

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

顯示效果:


鏈接

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

在方括號寫下鏈接文字,圓括號寫下網址即可。

外部鏈接

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

顯示效果:

這是簡書的首頁

內部鏈接1

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

顯示效果:

demo1
點擊的話會跳轉到demo1.md文件

內部鏈接2

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

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

效果:
代碼塊 demo

引用式鏈接

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

使用時,直接書寫 “[百度]” 即可實現鏈接效果


強調

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

斜體

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

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

顯示效果:

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

加粗

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

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

顯示效果:

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

斜體并加粗

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

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

顯示效果:

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

刪除線

在文字倆旁各加2個 “~” 即可實現刪除線的效果:

~~¥199.00~~

顯示效果:

¥199.00


引用

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

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

顯示效果:

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

在引用的區域內,也可以使用其他的 Markdown 語法,包括標題、列表等,例如:

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

顯示效果:

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


分割線

在 Markdown 中,可以用分隔線來將內容分成不同區域。
這里有三種寫法,三個“-”、三個“*”、三個“_”,都可實現分割線的效果:

  • ---
  • ***
  • ___

顯示效果都是:


簡書中編輯代碼

在markdown中編輯代碼段,分為塊式代碼和行內代碼

塊式代碼

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

```
let add = ( ...val )=>{ // 不定參數求和
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 )=>{     // 不定參數求和
    let result = 0;
    for( let i = 0; i < val.length; i++ ){
        result += val[i];
    }
    return result;
}
console.log( add( 100, 200 ) );     // 300
行內代碼

代碼的開頭和結尾各打一個 "`" 即可:

我們如果要在瀏覽器中彈出信息,可以使用`alert( " hello " )`。

效果:

我們如果要在瀏覽器中彈出信息,可以使用alert( " hello " )

表格

表格有時是挺有用的,這里講解一下,一個基礎的表格實現方式:

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

效果:

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

這里可以定義表格的對齊方式,分別是居左對齊(默認)、居中對齊、居右對齊,實現方式就是:

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

也就是在不同的位置加冒號,效果:

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

表情

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


復雜場景的實現

圖片鏈接

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

混合強調樣式
  • ***加粗傾斜***
  • **~~加粗刪除~~**
  • ***~~加粗傾斜刪除~~***

效果:

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

推薦閱讀更多精彩內容

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