題記
為什么使用Markdown?這是一個(gè)問(wèn)題。答案有很多種。比如,不局限于格式啦,比如.xls
文檔得用excel打開(kāi)吧,.doc
文檔得用word打開(kāi)吧,.xxx
得用xxx打開(kāi)吧。如果你機(jī)子上沒(méi)有這個(gè)軟件,豈不是抓瞎了,還能不能愉快的學(xué)習(xí)了?!因此你需要一種能使用簡(jiǎn)單的文本編輯器就可以書(shū)寫(xiě),有瀏覽器就可正常顯示的格式或標(biāo)記,Markdown很適合哦。什么,這個(gè)理由不好?那么就權(quán)當(dāng)是裝B吧,你說(shuō)你用Markdown寫(xiě)文檔,是不是逼格一下就上去了。(哎,估計(jì)也只有我這種新手才用來(lái)炫耀,大牛都是不屑的。)
正文
二八定律說(shuō):
百分之二十的知識(shí)解決百分之八十的問(wèn)題。
其實(shí)你只需要掌握基本語(yǔ)法標(biāo)記就可以愉快的玩耍了。經(jīng)過(guò)幾個(gè)月使用Markdown寫(xiě)文檔,發(fā)現(xiàn)掌握下面這些標(biāo)記語(yǔ)法,就可以完成日常文檔書(shū)寫(xiě)了。什么?要畫(huà)流程圖?這些需求對(duì)于大部分時(shí)間來(lái)說(shuō),你是用不到的,你只需要建立一個(gè)知識(shí)儲(chǔ)備就好。遇到了想不起來(lái)?打開(kāi)看一下就是了。想記住?對(duì)不起,這種事倍功半的事情,還是少做為妙,畢竟時(shí)間是硫酸,管你是什么都能夠腐化,只是快慢而已。
那么問(wèn)題來(lái)了,為什么這幾個(gè)常用的要記住呢?因?yàn)檫@幾個(gè)是經(jīng)常使用的,雖然熟能生巧,日久便記住了,但是在熟能生巧的路上總不能天天翻看知識(shí)儲(chǔ)備吧。太影響效率。何不花一點(diǎn)點(diǎn)時(shí)間強(qiáng)行記住,那么在日久記住的道路上,豈不是一路順風(fēng)?閑話不多說(shuō),來(lái)看看你要掌握的語(yǔ)法標(biāo)記吧。如果你想學(xué)習(xí)和使用Markdown,我建議:
- 常用標(biāo)記要先花一些時(shí)間熟記,后面經(jīng)常使用的話就會(huì)形成習(xí)慣了,不過(guò)腦的正常書(shū)寫(xiě),跟打字一樣;
- 次常用標(biāo)記要有基本的印象,能記住也是可以的;
- 不常用標(biāo)記和專(zhuān)用標(biāo)記just看看就好,等到使用的時(shí)候百度一下,你就知道。
1. 常用標(biāo)記
1.1 標(biāo)題
1.1.1 說(shuō)明
- 使用
#
表示標(biāo)題,一級(jí)標(biāo)題使用一個(gè)#
,二級(jí)標(biāo)題使用兩個(gè)##
,以此類(lèi)推,共有六級(jí)標(biāo)題。 - 使用
=====
表示高階標(biāo)題,使用---------
表示次階標(biāo)題。
1.1.2 示例
# 這是一級(jí)標(biāo)題
## 這是二級(jí)標(biāo)題
### 這是三級(jí)標(biāo)題
###### 這是六級(jí)標(biāo)題
這是高階標(biāo)題(效果和一級(jí)標(biāo)題一樣 )
========
這是次階標(biāo)題(效果和二級(jí)標(biāo)題一樣)
--------------
這是一級(jí)標(biāo)題
這是二級(jí)標(biāo)題
這是三級(jí)標(biāo)題
這是六級(jí)標(biāo)題
這是高階標(biāo)題(效果和一級(jí)標(biāo)題一樣 )
這是次階標(biāo)題(效果和二級(jí)標(biāo)題一樣)
1.1.3 注意
-
#
和標(biāo)題之間最好加一個(gè)空格。不要問(wèn)我為什么,貌似有時(shí)候不會(huì)被識(shí)別為標(biāo)題?已經(jīng)忘記自己為什么要加空格了,也許是任性。 -
====
和----
表示標(biāo)題時(shí),大于等于2個(gè)都可以表示。 - 我通常在標(biāo)題分級(jí)時(shí)使用標(biāo)題標(biāo)記,這個(gè)的用處很明了了。
1.2 目錄
1.2.1 說(shuō)明
使用[TOC]
生成目錄。如一開(kāi)始的目錄所示。
1.2.2 示例
[TOC]
[TOC]
1.2.3 注意
- 如果你的標(biāo)題都是按照Markdown語(yǔ)法書(shū)寫(xiě)的話,可以自動(dòng)生成層級(jí)目錄。
- 我常用 為知筆記 記筆記,可惜為知筆記不支持[TOC]標(biāo)記,一個(gè)悲傷的故事。
-
[TOC]
標(biāo)記可能只能放在一級(jí)標(biāo)題的前面,視不同的編譯器而定。
1.3 引用
1.3.1 說(shuō)明
使用>
表示引用,>>
表示引用里面再套一層引用,依次類(lèi)推。
1.3.2 示例
例1:
> 這是一級(jí)引用
>>這是二級(jí)引用
>>> 這是三級(jí)引用
>這是一級(jí)引用
這是一級(jí)引用
這是二級(jí)引用
這是三級(jí)引用
這是一級(jí)引用
例2:
> 這是一級(jí)引用
>>這是二級(jí)引用
>>> 這是三級(jí)引用
>這是一級(jí)引用
這是一級(jí)引用
這是二級(jí)引用
這是三級(jí)引用
這是一級(jí)引用
1.3.3 注意
- 如果
>
和>>
嵌套使用的話,從>>
退到>
時(shí),必須之間要加一個(gè)空格或者>
作為過(guò)渡,否則默認(rèn)為下一行和上一行是同一級(jí)別的引用。如示例所示。 - 引用標(biāo)記里可以使用其他標(biāo)記,如:有序列表或無(wú)序列表標(biāo)記,代碼標(biāo)記等。
- 我通常在引用別人的話或者某些時(shí)候做說(shuō)明時(shí)使用引用標(biāo)記,其實(shí)我一直拿不準(zhǔn)到底什么情況下使用引用標(biāo)記才是正確的。如果你知道,我只想說(shuō):請(qǐng)務(wù)必告訴我。
1.4 代碼塊
1.4.1 說(shuō)明
使用```表示代碼塊。
1.4.2 示例
```javascript
var canvas = document.getElementById("canvas");
var context = canvas.getContext("2d");
```
var canvas = document.getElementById("canvas");
var context = canvas.getContext("2d");
1.4.3 注意
- `這個(gè)符號(hào)是在
Esc
鍵下面,切換到英文下即可。 - ```后面的
javascript
表示此段代碼為javascript代碼,Markdown會(huì)自行使用javascript代碼顏色渲染。這里也可以不寫(xiě)。PS:誰(shuí)能夠提供一個(gè)完整的Markdown可以渲染的語(yǔ)言列表啊,比如:linux命令這里寫(xiě)什么? - 本文檔所有使用講解Markdown語(yǔ)法標(biāo)記示例的地方都是使用代碼塊標(biāo)記的。
1.5 行內(nèi)代碼
1.5.1 說(shuō)明
使用``表示行內(nèi)代碼。
1.5.2 示例
這是`javascript`代碼
這是javascript
代碼
1.5.3 注意
- 本頁(yè)部分文字中間的英文字母就是使用行內(nèi)代碼標(biāo)記標(biāo)記的。
- 這個(gè)的使用場(chǎng)景我也有些模糊。我常在文字間有英文的時(shí)候使用,但有時(shí)又不知道該不該使用,困擾。如果你知道,請(qǐng)告訴我。
1.6 導(dǎo)入圖片
1.6.1 說(shuō)明
使用
導(dǎo)入圖片。其中:
-
Alt text
為如果圖片無(wú)法顯示時(shí)顯示的文字; -
/path/to/img.jpg
為圖片所在路徑; -
Optional title
為顯示標(biāo)題。顯示效果為在你將鼠標(biāo)放到圖片上后,會(huì)顯示一個(gè)小框提示,提示的內(nèi)容就是Optional title
里的內(nèi)容。
1.6.2 示例

1.6.3 注意
- 導(dǎo)入的圖片路徑可以使用絕對(duì)路徑也可以使用相對(duì)路徑,建議使用相對(duì)路徑。
- 我通常的做法是Markdown文檔的同級(jí)目錄下建立一個(gè)pictures文件夾,里面放置所有所需的圖片,如果圖片多的話,你也可以在pictures文件夾里建立子文件夾歸類(lèi)。
1.7 列表
1.7.1 說(shuō)明
使用1. 2. 3.
表示有序列表,使用*
或-
或+
表示無(wú)序列表。
1.7.2 示例
例1:有序列表
1. 第一點(diǎn)
2. 第二點(diǎn)
4. 第三點(diǎn)
- 第一點(diǎn)
- 第二點(diǎn)
- 第三點(diǎn)
例2:無(wú)序列表
+ 呵呵
* 嘉嘉
- 嘻嘻
- 吼吼
- 嘎嘎
+ 桀桀
* 哈哈
- 呵呵
- 嘉嘉
- 嘻嘻
- 吼吼
- 嘎嘎
- 桀桀
- 哈哈
1.7.3 注意
- 無(wú)序列表或有序列表標(biāo)記和后面的文字之間要有一個(gè)空格隔開(kāi)。
- 有序列表標(biāo)記不是按照你寫(xiě)的數(shù)字進(jìn)行顯示的,而是根據(jù)當(dāng)前有序列表標(biāo)記所在位置顯示的,如示例1所示。
- 無(wú)序列表的項(xiàng)目符號(hào)是按照實(shí)心圓、空心圓、實(shí)心方格的層級(jí)關(guān)系遞進(jìn)的,如例2所示。通常情況下,同一層級(jí)使用同一種標(biāo)記表示,便于自己查看和管理。
- 無(wú)序列表和有序列表標(biāo)記的使用場(chǎng)景也很明了,故不多說(shuō)。
1.8 粗體和斜體
1.8.1 說(shuō)明
使用 **
或者 __
表示粗體。
使用 *
或者 _
表示斜體。
1.8.2 示例
**粗體1** __粗體2__
*斜體1* _斜體2_
粗體1 粗體2
斜體1 斜體2
1.8.3 注意
- 前后的
*
或_
與要加粗或傾斜的字體之間不能有空格。 - 我通常在強(qiáng)調(diào)時(shí)使用加粗標(biāo)記,在和一行中的加粗區(qū)分且也表示強(qiáng)調(diào)時(shí)使用傾斜標(biāo)記,這里的傾斜標(biāo)記的使用場(chǎng)景不明確。如果你知道:請(qǐng)務(wù)必告訴我。
1.9 表格
1.9.1 說(shuō)明
具體使用方式請(qǐng)看示例。
-
------:
為右對(duì)齊。 -
:------
為左對(duì)齊。 -
:------:
為居中對(duì)齊。 -
-------
為使用默認(rèn)居中對(duì)齊。
1.9.2 示例
| 序號(hào) | 交易名 | 交易說(shuō)明 | 備注 |
| ------: | :-------: | :--------- | ------ |
| 1 | prfcfg | 菜單配置 | 可以通過(guò)此交易查詢(xún)到所有交易碼和菜單的對(duì)應(yīng)關(guān)系 |
| 2 | gentmo | 編譯所有交易 | |
| 100000 | sysdba | 數(shù)據(jù)庫(kù)表模型匯總 | |
序號(hào) | 交易名 | 交易說(shuō)明 | 備注 |
---|---|---|---|
1 | prfcfg | 菜單配置 | 可以通過(guò)此交易查詢(xún)到所有交易碼和菜單的對(duì)應(yīng)關(guān)系 |
2 | gentmo | 編譯所有交易 | |
100000 | sysdba | 數(shù)據(jù)庫(kù)表模型匯總 |
1.9.3 注意
- 每個(gè)Markdown解析器都不一樣,可能左右居中對(duì)齊方式的表示方式不一樣。
1.10 分割線
1.10.1 說(shuō)明
使用---
或者***
或者* * *
表示水平分割線。
1.10.2 示例
---
***
* * *
1.10.3 注意
- 只要
*
或者-
大于等于三個(gè)就可組成一條平行線。 - 使用
---
作為水平分割線時(shí),要在它的前后都空一行,防止---
被當(dāng)成標(biāo)題標(biāo)記的表示方式。
1.11 鏈接
1.11.1 說(shuō)明
使用[](link "Optional title")
表示行內(nèi)鏈接。其中:
-
[]
內(nèi)的內(nèi)容為要添加鏈接的文字。 -
link
為鏈接地址。 -
Optional title
為顯示標(biāo)題。顯示效果為在你將鼠標(biāo)放到鏈接上后,會(huì)顯示一個(gè)小框提示,提示的內(nèi)容就是Optional title
里的內(nèi)容。
參考式鏈接如例所示。
1.11.2 示例
例1:行內(nèi)鏈接
這就是我們常用的地址:[Baidu](www.baidu.com "百度一下,你就知道" )
這就是我們常用的地址:Baidu
例2:參考式鏈接
這就是我們常用的地址:[Baidu][1]
[1]:www.baidu.com "百度一下,你就知道"
這就是我們常用的地址:Baidu
1.11.3 注意
- 參考式鏈接和行內(nèi)鏈接的顯示效果是一樣的,但是在編輯狀態(tài)下的使用情況不一樣。行內(nèi)連接緊跟鏈接文字,可以在看到鏈接文字的同時(shí)清楚的知道鏈接地址,但是不便于多次重復(fù)利用。參考式鏈接可以重復(fù)使用,但一般都是將一些鏈接放在一起統(tǒng)一管理,如一段文字后面或文章結(jié)尾,因此在找到鏈接和鏈接文字的對(duì)應(yīng)關(guān)系上有些麻煩。各有利弊了,分情況使用。
- 使用場(chǎng)景很明了,不多說(shuō)。
1.11 反斜杠
1.11.1 說(shuō)明
使用\
表示反斜杠。在你不想顯示Markdown標(biāo)記時(shí)可以使用反斜杠。
1.11.2 示例
\*這里不會(huì)顯示斜體\*
*這里不會(huì)顯示斜體*
1.11.3 注意
無(wú)。
1.12 空格
1.12.1 說(shuō)明
Markdown語(yǔ)法會(huì)忽略首行開(kāi)頭的空格,如果要體現(xiàn)出首行開(kāi)頭空兩個(gè)的效果,可以使用全角符號(hào)下的空格,windows下使用shift+空格
切換。
1.12.2 示例
無(wú)。
1.12.3 注意
無(wú)。
2. 次常用標(biāo)記
2.1 標(biāo)簽分類(lèi)
2.1.1 說(shuō)明
使用標(biāo)簽:
或者Tags:
表示標(biāo)簽標(biāo)記。
2.1.2 示例
標(biāo)簽: 數(shù)學(xué) 英語(yǔ)
Tags: 數(shù)學(xué) 英語(yǔ)
標(biāo)簽: 數(shù)學(xué) 英語(yǔ)
Tags: 數(shù)學(xué) 英語(yǔ)
2.1.3 注意
-
標(biāo)簽:
或者Tags:
的冒號(hào)要使用半角冒號(hào)。 - 基本沒(méi)使用過(guò)這個(gè)標(biāo)記,不過(guò)應(yīng)用場(chǎng)景應(yīng)該是歸類(lèi)。便于快速了解文章分類(lèi)。難道可以通過(guò)某種方式來(lái)遍歷到標(biāo)簽標(biāo)記?不甚了解。如你知道:請(qǐng)告訴我。
2.2 刪除線
2.2.1 說(shuō)明
使用 ~~
表示刪除線。
2.2.2 示例
~~這是一條刪除線~~
這是一條刪除線
2.2.3 注意
- 注意
~~
和 要添加刪除線的文字之間不能有空格。 - 我常使用在顯示的告訴自己這行文字是要?jiǎng)h除的。
2.3 注腳
2.3.1 說(shuō)明
使用 [^footer] 表示注腳。
2.3.2 示例
這是一個(gè)注腳測(cè)試[^footer1]。
[^footer1]: 這是一個(gè)測(cè)試,用來(lái)闡釋注腳。
這是一個(gè)注腳測(cè)試[1]。
2.3.3 注意
- 我常在需要解釋一個(gè)名詞,或者一本書(shū),或者一個(gè)人時(shí)使用腳注標(biāo)記。
3. 不常用標(biāo)記
3.1 實(shí)現(xiàn)頁(yè)內(nèi)跳轉(zhuǎn)
3.1.1 說(shuō)明
使用html代碼實(shí)現(xiàn)頁(yè)內(nèi)跳轉(zhuǎn)。在要跳轉(zhuǎn)到的位置定義個(gè)錨<span id = "jump">hehe</span>
,然后使用[你好](#jump)
將你好
設(shè)置為一單擊即跳轉(zhuǎn)到hehe
所在位置的效果。
3.1.2 示例
[你好](#jump)
<span id = "jump">hehe</span>
你好
<span id = "jump">hehe</span>
3.1.3 注意
無(wú)。
4. 專(zhuān)項(xiàng)使用標(biāo)記
4.1 流程圖
以后在總結(jié)吧,現(xiàn)在的我完全沒(méi)有使用上,沒(méi)有需求就先不總結(jié)了。
4.2 LaTeX公式
以后在總結(jié)吧,現(xiàn)在的我完全沒(méi)有使用上,沒(méi)有需求就先不總結(jié)了。
寫(xiě)在后面的話
- [TOC]不支持呀不支持,看不到效果了。
- 誰(shuí)有什么好的方式在博客園中更好的顯示Markdown,像作業(yè)部落一樣。
- 更好的Markdown閱讀效果:Markdown,你只需要掌握這幾個(gè)
以上都是我學(xué)習(xí)到的,然后經(jīng)過(guò)幾個(gè)月的使用總結(jié)的,針對(duì)我的常用非常用分類(lèi)。如果有描述的不對(duì)的地方,歡迎批評(píng)指正,共同進(jìn)步。
-
這是一個(gè)測(cè)試,用來(lái)闡釋注腳。 ?