Markdown,你只需要掌握這幾個(gè)

題記

為什么使用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 注意
  1. #和標(biāo)題之間最好加一個(gè)空格。不要問(wèn)我為什么,貌似有時(shí)候不會(huì)被識(shí)別為標(biāo)題?已經(jīng)忘記自己為什么要加空格了,也許是任性。
  2. ====----表示標(biāo)題時(shí),大于等于2個(gè)都可以表示。
  3. 我通常在標(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 注意
  1. 如果你的標(biāo)題都是按照Markdown語(yǔ)法書(shū)寫(xiě)的話,可以自動(dòng)生成層級(jí)目錄。
  2. 我常用 為知筆記 記筆記,可惜為知筆記不支持[TOC]標(biāo)記,一個(gè)悲傷的故事。
  3. [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 注意
  1. 如果>>>嵌套使用的話,從>>退到>時(shí),必須之間要加一個(gè)空格或者>作為過(guò)渡,否則默認(rèn)為下一行和上一行是同一級(jí)別的引用。如示例所示。
  2. 引用標(biāo)記里可以使用其他標(biāo)記,如:有序列表或無(wú)序列表標(biāo)記,代碼標(biāo)記等。
  3. 我通常在引用別人的話或者某些時(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 注意
  1. `這個(gè)符號(hào)是在Esc鍵下面,切換到英文下即可。
  2. ```后面的javascript表示此段代碼為javascript代碼,Markdown會(huì)自行使用javascript代碼顏色渲染。這里也可以不寫(xiě)。PS:誰(shuí)能夠提供一個(gè)完整的Markdown可以渲染的語(yǔ)言列表啊,比如:linux命令這里寫(xiě)什么?
  3. 本文檔所有使用講解Markdown語(yǔ)法標(biāo)記示例的地方都是使用代碼塊標(biāo)記的。

1.5 行內(nèi)代碼

1.5.1 說(shuō)明

使用``表示行內(nèi)代碼。

1.5.2 示例
這是`javascript`代碼

這是javascript代碼

1.5.3 注意
  1. 本頁(yè)部分文字中間的英文字母就是使用行內(nèi)代碼標(biāo)記標(biāo)記的。
  2. 這個(gè)的使用場(chǎng)景我也有些模糊。我常在文字間有英文的時(shí)候使用,但有時(shí)又不知道該不該使用,困擾。如果你知道,請(qǐng)告訴我。

1.6 導(dǎo)入圖片

1.6.1 說(shuō)明

使用![](/path/to/img.jpg "Optional title")導(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 示例
![Markdown](http://upload-images.jianshu.io/upload_images/264547-6f7ae1eea011043a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
Markdown
1.6.3 注意
  1. 導(dǎo)入的圖片路徑可以使用絕對(duì)路徑也可以使用相對(duì)路徑,建議使用相對(duì)路徑。
  2. 我通常的做法是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)
  1. 第一點(diǎn)
  2. 第二點(diǎn)
  3. 第三點(diǎn)

例2:無(wú)序列表

+ 呵呵
    * 嘉嘉
    - 嘻嘻
    - 吼吼
        - 嘎嘎
        + 桀桀
* 哈哈
  • 呵呵
    • 嘉嘉
    • 嘻嘻
    • 吼吼
      • 嘎嘎
      • 桀桀
  • 哈哈
1.7.3 注意
  1. 無(wú)序列表或有序列表標(biāo)記和后面的文字之間要有一個(gè)空格隔開(kāi)。
  2. 有序列表標(biāo)記不是按照你寫(xiě)的數(shù)字進(jìn)行顯示的,而是根據(jù)當(dāng)前有序列表標(biāo)記所在位置顯示的,如示例1所示。
  3. 無(wú)序列表的項(xiàng)目符號(hào)是按照實(shí)心圓、空心圓、實(shí)心方格的層級(jí)關(guān)系遞進(jìn)的,如例2所示。通常情況下,同一層級(jí)使用同一種標(biāo)記表示,便于自己查看和管理。
  4. 無(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 注意
  1. 前后的 *_ 與要加粗或傾斜的字體之間不能有空格。
  2. 我通常在強(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 注意
  1. 每個(gè)Markdown解析器都不一樣,可能左右居中對(duì)齊方式的表示方式不一樣。

1.10 分割線

1.10.1 說(shuō)明

使用---或者***或者* * *表示水平分割線。

1.10.2 示例

---

***

* * *



1.10.3 注意
  1. 只要*或者-大于等于三個(gè)就可組成一條平行線。
  2. 使用---作為水平分割線時(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 注意
  1. 參考式鏈接和行內(nèi)鏈接的顯示效果是一樣的,但是在編輯狀態(tài)下的使用情況不一樣。行內(nèi)連接緊跟鏈接文字,可以在看到鏈接文字的同時(shí)清楚的知道鏈接地址,但是不便于多次重復(fù)利用。參考式鏈接可以重復(fù)使用,但一般都是將一些鏈接放在一起統(tǒng)一管理,如一段文字后面或文章結(jié)尾,因此在找到鏈接和鏈接文字的對(duì)應(yīng)關(guān)系上有些麻煩。各有利弊了,分情況使用。
  2. 使用場(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 注意
  1. 標(biāo)簽:或者Tags:的冒號(hào)要使用半角冒號(hào)。
  2. 基本沒(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 注意
  1. 注意 ~~ 和 要添加刪除線的文字之間不能有空格。
  2. 我常使用在顯示的告訴自己這行文字是要?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 注意
  1. 我常在需要解釋一個(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ě)在后面的話

以上都是我學(xué)習(xí)到的,然后經(jīng)過(guò)幾個(gè)月的使用總結(jié)的,針對(duì)我的常用非常用分類(lèi)。如果有描述的不對(duì)的地方,歡迎批評(píng)指正,共同進(jìn)步。


  1. 這是一個(gè)測(cè)試,用來(lái)闡釋注腳。 ?

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容

  • 亞洲氣質(zhì)舞王·尼古拉斯趙四 常用標(biāo)記1.1 標(biāo)題1.1.1 說(shuō)明使用 #表示標(biāo)題,一級(jí)標(biāo)題使用一個(gè) #,二級(jí)標(biāo)題使...
    candyLong閱讀 2,776評(píng)論 0 2
  • Markdown,你只需要掌握這幾個(gè)
    Windream閱讀 283評(píng)論 0 0
  • Spring Cloud為開(kāi)發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見(jiàn)模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 134,951評(píng)論 19 139
  • 為什么學(xué)習(xí)Markdown 自從搭建了 Hexo 博客之后,發(fā)現(xiàn)還有 Markdown 這種寫(xiě)文章的方法,想到以后...
    lifeColder閱讀 20,194評(píng)論 10 216
  • 【打卡】D21 6-Donna King 【項(xiàng)目1】5點(diǎn)起床? 【項(xiàng)目2】時(shí)間記錄? 【項(xiàng)目3】親子一事(晚上帶孩...
    韋陀閱讀 369評(píng)論 0 1