Markdown使用
一挺物、介紹
考慮到周圍不少同學(xué)不太了解markdown以及從未使用過markdown,這里對(duì)markdown進(jìn)行一下介紹。我平時(shí)寫公眾號(hào)文章全部是使用markdown編寫,之后使用相應(yīng)的格式轉(zhuǎn)換工具排版,比起word要方便很多(當(dāng)然如果word用的很熟練的話自然是不比markdown差的七扰,我就屬于word用得不太利索的…)
markdown在平時(shí)的工作生活中有很多方便的使用場(chǎng)景,例如做筆記陪白,進(jìn)行項(xiàng)目記錄颈走,寫報(bào)告等等。它可以讓你暫時(shí)性忽略復(fù)雜的排版咱士,僅僅從文章結(jié)構(gòu)出發(fā)立由,通過一系列標(biāo)記形成文本的結(jié)構(gòu)轧钓,大家體驗(yàn)一下就知道他有多方便啦~
Markdown是一種輕量級(jí)標(biāo)記語言,創(chuàng)始人為約翰·格魯伯(John Gruber)锐膜。它允許人們使用易讀易寫的純文本格式編寫文檔毕箍,然后轉(zhuǎn)換成有效的XHTML(或者HTML)文檔。這種語言吸收了很多在電子郵件中已有的純文本標(biāo)記的特性道盏。
- Markdown 編寫的文檔可以導(dǎo)出 HTML 而柑、Word、圖像荷逞、PDF媒咳、Epub 等多種格式的文檔。
- Markdown 編寫的文檔后綴為 .md, .markdown种远。
二涩澡、編輯器
由于Markdown的輕量化、易讀易寫特性院促,并且對(duì)于圖片筏养,圖表、數(shù)學(xué)式都有支持,目前許多網(wǎng)站都廣泛使用Markdown來撰寫幫助文檔或是用于論壇上發(fā)表消息, 如GitHub灾而、Stack Exchange傅事、OpenStreetMap 、SourceForge宪郊、CSDN論壇掂恕、簡(jiǎn)書等,甚至還能被使用來撰寫電子書弛槐。
編寫Markdown的編輯器有很多懊亡,比如Typora,Sublmie Text等乎串。一些博客網(wǎng)站也支持Markdown編寫比如CSDN店枣、簡(jiǎn)書等等,而且還有預(yù)覽功能叹誉,Sublime Text好像沒有預(yù)覽功能鸯两,對(duì)于一些新入手Markdown的童鞋來說還是選擇有預(yù)覽功能的編輯器比較好。不過CSDN在插入圖片的時(shí)候好像會(huì)自動(dòng)給你加上你博客賬戶的水印长豁,如果單純寫Markdown文件钧唐,加上水印就不太好了,所以大家可以下載專用的編輯器匠襟,比如Typora钝侠,就像編代碼一樣使用哈哈哈哈该园。除此之外,一些編程軟件的集成開發(fā)環(huán)境也支持Markdown的編寫帅韧,比如JetBrains全家桶爬范,可以用來寫幫助文檔或則接口文檔。
三弱匪、使用方法
標(biāo)題
Markdown有兩種標(biāo)題表示方法:
(1)使用 = 和 - 標(biāo)記以及和二級(jí)標(biāo)題
用我來表示一級(jí)標(biāo)題
=================
用我來表示二級(jí)標(biāo)題
-----------------
(2)使用#標(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)題可以快速生成文章結(jié)構(gòu)圖,例如(下圖右邊)
段落
Markdown 段落沒有特殊的格式帘饶,直接編寫文字就好哑诊,段落的換行是使用兩個(gè)以上空格加上回車。當(dāng)然也可以在段落后面使用一個(gè)空行來表示重新開始一個(gè)段落及刻。
從上圖可以看到兩個(gè)換行方式镀裤,第一行的換行就是兩個(gè)空格加回車的換行方式,后面會(huì)有一個(gè)豎直向下的箭頭缴饭;第二行就是使用一個(gè)空行表示重新開始的一個(gè)段落暑劝。其實(shí)直接回車也可以的哈哈哈哈。
字體
Markdown 可以使用以下幾種字體:
*斜體文本*
_斜體文本_
**粗體文本**
__粗體文本__
***粗斜體文本***
___粗斜體文本___
是不是感覺很簡(jiǎn)單呢颗搂。
刪除線和下劃線
刪除線可以用~~
來標(biāo)記担猛,下劃線可以使用html的<u>
標(biāo)簽來標(biāo)記:
Markdown刪除線
~~Markdown刪除線~~
Markdown下劃線
<u>Markdown下劃線</u>
腳注
腳注是對(duì)文本的補(bǔ)充說明。Markdown 腳注的格式如下:
[^要注明的文本]
示例:
創(chuàng)建腳注格式[^ 腳注]
[^ 腳注]: 這是一個(gè)腳注
當(dāng)把鼠標(biāo)移動(dòng)到腳注上時(shí)丢氢,就會(huì)顯示出腳注信息傅联。
分割線
Markdown可以在一行中用三個(gè)以上的星號(hào)、減號(hào)疚察、底線來建立一個(gè)分隔線蒸走,行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格貌嫡。下面每種寫法都可以建立分隔線:
***
* * *
*****
- - -
----------
列表
Markdown 支持有序列表和無序列表:
無序列表使用星號(hào)(*)比驻、加號(hào)(+)或是減號(hào)(-)作為列表標(biāo)記,這些標(biāo)記后面要添加一個(gè)空格衅枫,然后再填寫內(nèi)容:
下面是列表
* 列表第一項(xiàng)
* 列表第二項(xiàng)
* 列表第三項(xiàng)
+ 列表第1.1項(xiàng)
+ 列表第2.2項(xiàng)
+ 列表第3.3項(xiàng)
- 列表第one項(xiàng)
- 列表第two項(xiàng)
- 列表第three項(xiàng)
可以發(fā)現(xiàn)列表都是自帶縮進(jìn)的嫁艇。
有序列表使用數(shù)字并加上 . 號(hào)來表示,如:
hello
1. Firstly
2. Secondly
3. Thirdly
列表嵌套
列表嵌套只需在子列表中的選項(xiàng)前面添加四個(gè)空格即可:
1. 第一項(xiàng):
- 第一項(xiàng)嵌套的第一個(gè)元素
- 第一項(xiàng)嵌套的第二個(gè)元素
2. 第二項(xiàng):
- 第二項(xiàng)嵌套的第一個(gè)元素
- 第二項(xiàng)嵌套的第二個(gè)元素
區(qū)塊
Markdown 區(qū)塊引用是在段落開頭使用>
符號(hào) 弦撩,然后后面緊跟一個(gè)空格符號(hào):
下面是區(qū)塊
> 天長(zhǎng)地久有時(shí)盡步咪,此恨綿綿無絕期。
>
> 一個(gè)普通的改變也能改變普通益楼。
>
> 我本將心向明月猾漫,奈何明月照溝渠
另外區(qū)塊是可以嵌套的点晴,一個(gè) > 符號(hào)是最外層,兩個(gè) > 符號(hào)是第一層嵌套悯周,以此類推:
> 天長(zhǎng)地久有時(shí)盡粒督,此恨綿綿無絕期
> > 一個(gè)普通的改變也能改變普通
> > > 我本將心向明月,奈何明月照溝渠
同樣在列表中可以使用區(qū)塊禽翼,在區(qū)塊中也可以使用列表屠橄,這里就不再舉例了,大家可以嘗試一下闰挡。
代碼
如果是段落上的一個(gè)函數(shù)或片段的代碼可以用反引號(hào)(`)把它包起來锐墙,例如:
`System.out.println("hello, World");`
代碼區(qū)塊
代碼區(qū)塊使用 4 個(gè)空格或者一個(gè)制表符(Tab 鍵)或者使用三個(gè)反引號(hào)(`)把代碼上下包起來:
?```
#include <iostream>
int main() {
printf("hello,world");
system("pause");
return 0;
}
?```
鏈接
[鏈接名稱](鏈接地址)
或者
<鏈接地址>
實(shí)例:
這是一個(gè)鏈接[西南大學(xué)](http://swu.edu.cn)
<http://swu.edu.cn>
Markdown還有一種高級(jí)鏈接方式,就是可以通過變量來設(shè)置一個(gè)鏈接长酗,變量賦值在文檔末尾進(jìn)行溪北。這個(gè)就不再詳細(xì)講了哈,大家感興趣可以百度一下夺脾。
插入圖片
Markdown插入圖片也有專門的語法之拨,但是一般都是直接把圖片復(fù)制粘貼進(jìn)編輯器即可,也可以直接截圖粘貼進(jìn)來咧叭,然后改一下圖片名稱即可蚀乔。至于具體的語法就不在詳細(xì)的講了。
![alt 屬性文本](圖片地址)
![alt 屬性文本](圖片地址 "可選標(biāo)題")
- 開頭一個(gè)感嘆號(hào) !
- 接著一個(gè)方括號(hào)佳簸,里面放上圖片的替代文字
- 接著一個(gè)普通括號(hào)乙墙,里面放上圖片的網(wǎng)址,最后還可以用引號(hào)包住并加上選擇性的 'title' 屬性的文字生均。
表格
Markdown 制作表格使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行腥刹。
語法格式如下:
| 表頭1 | 表頭2 |
| ---- | ---- |
| 單元格1 | 單元格2 |
| 單元格3 | 單元格4 |
我們可以設(shè)置表格的對(duì)齊方式:
- -: 設(shè)置內(nèi)容和標(biāo)題欄居右對(duì)齊马胧。
- :- 設(shè)置內(nèi)容和標(biāo)題欄居左對(duì)齊。
- :-: 設(shè)置內(nèi)容和標(biāo)題欄居中對(duì)齊衔峰。
| 左對(duì)齊 | 右對(duì)齊 | 居中對(duì)齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |
常用技巧
支持的 HTML 元素:
不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽佩脊,都可以直接在文檔里面用 HTML 撰寫。目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>
等 垫卤,如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦
轉(zhuǎn)義字符:
Markdown 使用了很多特殊符號(hào)來表示特定的意義威彰,如果需要顯示特定的符號(hào)則需要使用轉(zhuǎn)義字符,Markdown 使用反斜杠轉(zhuǎn)義特殊字符穴肘。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)
公式:
當(dāng)你需要在編輯器中插入數(shù)學(xué)公式時(shí)歇盼,可以使用兩個(gè)美元符 $$ 包裹 TeX 或 LaTeX 格式的數(shù)學(xué)公式來實(shí)現(xiàn)。提交后评抚,問答和文章頁會(huì)根據(jù)需要加載 Mathjax 對(duì)數(shù)學(xué)公式進(jìn)行渲染豹缀。如:
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$
熟練的話伯复,用markdown敲公式可快了
除了上面講的內(nèi)容之外,Markdown還可以繪制畫流程圖邢笙、時(shí)序圖(順序圖)啸如、甘特圖等圖形。是不是感覺很不可思議氮惯。感興趣的小伙伴可以在網(wǎng)上找一找如何繪制圖形叮雳。
四、語法總結(jié)
Markdown語法 | 詳解 |
---|---|
* | 標(biāo)記斜體 |
** | 標(biāo)記粗體文字 |
# 一級(jí)標(biāo)題 | "#"后需加空格 |
## 二級(jí)標(biāo)題 | 以此類推三級(jí)標(biāo)題為三個(gè)“#” |
[鏈接](URL地址) | “[]”間為顯示的超文本 |
![圖片](圖片地址) | “[]”間為圖片名 |
> 引用 | ">"后需加空格 |
* 無序列表 | “*” 后需加空格 |
1. 有序列表 | 數(shù)字后需加"." |
``` | 標(biāo)記代碼塊 |
Markdown語法簡(jiǎn)潔妇汗、使用便捷帘不。而且一般的編輯軟件都有很好的用戶圖形界面,非常的好用铛纬,即便很久沒有使用也能很快回憶起語法厌均。