http://www.cnblogs.com/crazyant007/p/4220066.html
題記
爲什麼使用Markdown?這是一個問題。答案有很多種。比如,不侷限於格式啦,比如.xls
文檔得用excel打開吧,.doc
文檔得用word打開吧,.xxx
得用xxx打開吧。如果你機子上沒有這個軟件,豈不是抓瞎了,還能不能愉快的學習了?!因此你需要一種能使用簡單的文本編輯器就可以書寫,有瀏覽器就可正常顯示的格式或標記,Markdown很適合哦。什麼,這個理由不好?那麼就權當是裝B吧,你說你用Markdown寫文檔,是不是逼格一下就上去了。(哎,估計也只有我這種新手才用來炫耀,大牛都是不屑的。)
正文
二八定律說:
百分之二十的知識解決百分之八十的問題。
其實你只需要掌握基本語法標記就可以愉快的玩耍了。經過幾個月使用Markdown寫文檔,發現掌握下面這些標記語法,就可以完成日常文檔書寫了。什麼?要畫流程圖?這些需求對於大部分時間來說,你是用不到的,你只需要建立一個知識儲備就好。遇到了想不起來?打開看一下就是了。想記住?對不起,這種事倍功半的事情,還是少做爲妙,畢竟時間是硫酸,管你是什麼都能夠腐化,只是快慢而已。 那麼問題來了,爲什麼這幾個常用的要記住呢?因爲這幾個是經常使用的,雖然熟能生巧,日久便記住了,但是在熟能生巧的路上總不能天天翻看知識儲備吧。太影響效率。何不花一點點時間強行記住,那麼在日久記住的道路上,豈不是一路順風?閒話不多說,來看看你要掌握的語法標記吧。如果你想學習和使用Markdown,我建議:
- __常用標記__要先花一些時間熟記,後面經常使用的話就會形成習慣了,不過腦的正常書寫,跟打字一樣;
- __次常用標記__要有基本的印象,能記住也是可以的;
- __不常用標記__和專用標記just看看就好,等到使用的時候百度一下,你就知道。
[TOC]
1. 常用標記
1.1 標題
1.1.1 說明
- 使用
#
表示標題,一級標題使用一個#
,二級標題使用兩個##
,以此類推,共有六級標題。 - 使用
=====
表示高階標題,使用---------
表示次階標題。
1.1.2 示例
# 這是一級標題 ## 這是二級標題 ### 這是三級標題 ###### 這是六級標題 這是高階標題(效果和一級標題一樣 ) ======== 這是次階標題(效果和二級標題一樣) --------------
這是一級標題
這是二級標題
這是三級標題
這是六級標題
這是高階標題(效果和一級標題一樣 )
這是次階標題(效果和二級標題一樣)
1.1.3 注意
#
和標題之間最好加一個空格。不要問我爲什麼,貌似有時候不會被識別爲標題?已經忘記自己爲什麼要加空格了,也許是任性。====
和----
表示標題時,大於等於2個都可以表示。- 我通常在標題分級時使用標題標記,這個的用處很明瞭了。
1.2 目錄
1.2.1 說明
使用[TOC]
生成目錄。如一開始的目錄所示。
1.2.2 示例
[TOC]
[TOC]
1.2.3 注意
- 如果你的標題都是按照Markdown語法書寫的話,可以自動生成層級目錄。
- 我常用 爲知筆記 記筆記,可惜爲知筆記不支持[TOC]標記,一個悲傷的故事。
[TOC]
標記可能只能放在一級標題的前面,視不同的編譯器而定。
1.3 引用
1.3.1 說明
使用>
表示引用,>>
表示引用裏面再套一層引用,依次類推。
1.3.2 示例
例1:
> 這是一級引用 >>這是二級引用 >>> 這是三級引用 >這是一級引用
這是一級引用 這是二級引用 這是三級引用
這是一級引用
例2:
> 這是一級引用 >>這是二級引用 >>> 這是三級引用 >這是一級引用
這是一級引用 這是二級引用 這是三級引用 這是一級引用
1.3.3 注意
- 如果
>
和>>
嵌套使用的話,從>>
退到>
時,必須之間要加一個空格或者>
作爲過渡,否則默認爲下一行和上一行是同一級別的引用。如示例所示。 - 引用標記裏可以使用其他標記,如:有序列表或無序列表標記,代碼標記等。
- 我通常在引用別人的話或者某些時候做說明時使用引用標記,其實我一直拿不準到底什麼情況下使用引用標記纔是正確的。如果你知道,我只想說:請務必告訴我。
1.4 代碼塊
1.4.1 說明
使用```表示代碼塊。
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 注意
- `這個符號是在
Esc
鍵下面,切換到英文下即可。 - ```後面的
javascript
表示此段代碼爲javascript代碼,Markdown會自行使用javascript代碼顏色渲染。這裏也可以不寫。PS:誰能夠提供一個完整的Markdown可以渲染的語言列表啊,比如:linux命令這裏寫什麼? - 本文檔所有使用講解Markdown語法標記示例的地方都是使用代碼塊標記的。
1.5 行內代碼
1.5.1 說明
使用``表示行內代碼。
1.5.2 示例
這是`javascript`代碼
這是javascript
代碼
1.5.3 注意
- 本頁部分文字中間的英文字母就是使用行內代碼標記標記的。
- 這個的使用場景我也有些模糊。我常在文字間有英文的時候使用,但有時又不知道該不該使用,困擾。如果你知道,請告訴我。
1.6 導入圖片
1.6.1 說明
使用![Alt text](/path/to/img.jpg "Optional title")
導入圖片。其中:
Alt text
爲如果圖片無法顯示時顯示的文字;/path/to/img.jpg
爲圖片所在路徑;Optional title
爲顯示標題。顯示效果爲在你將鼠標放到圖片上後,會顯示一個小框提示,提示的內容就是Optional title
裏的內容。
1.6.2 示例
![Markdown](http://images.cnitblog.com/blog/404392/201501/122257231047591.jpg)
1.6.3 注意
- 導入的圖片路徑可以使用絕對路徑也可以使用相對路徑,建議使用相對路徑。
- 我通常的做法是Markdown文檔的同級目錄下建立一個pictures文件夾,裏面放置所有所需的圖片,如果圖片多的話,你也可以在pictures文件夾裏建立子文件夾歸類。
1.7 列表
1.7.1 說明
使用1. 2. 3.
表示有序列表,使用*
或-
或+
表示無序列表。
1.7.2 示例
例1:有序列表
1. 第一點 2. 第二點 4. 第三點
- 第一點
- 第二點
- 第三點
例2:無序列表
+ 呵呵 * 嘉嘉 - 嘻嘻 - 吼吼 - 嘎嘎 + 桀桀 * 哈哈
- 呵呵
- 嘉嘉
- 嘻嘻
- 吼吼
- 嘎嘎
- 桀桀
- 哈哈
1.7.3 注意
- 無序列表或有序列表標記和後面的文字之間要有一個空格隔開。
- 有序列表標記不是按照你寫的數字進行顯示的,而是根據當前有序列表標記所在位置顯示的,如示例1所示。
- 無序列表的項目符號是按照實心圓、空心圓、實心方格的層級關係遞進的,如例2所示。通常情況下,同一層級使用同一種標記表示,便於自己查看和管理。
- 無序列表和有序列表標記的使用場景也很明瞭,故不多說。
1.8 粗體和斜體
1.8.1 說明
使用 **
或者 __
表示粗體。
使用 *
或者 _
表示斜體。
1.8.2 示例
**粗體1** __粗體2__ *斜體1* _斜體2_
粗體1 粗體2 斜體1 斜體2
1.8.3 注意
- 前後的
*
或_
與要加粗或傾斜的字體之間不能有空格。 - 我通常在強調時使用加粗標記,在和一行中的加粗區分且也表示強調時使用傾斜標記,這裏的傾斜標記的使用場景不明確。如果你知道:請務必告訴我。
1.9 表格
1.9.1 說明
具體使用方式請看示例。
------:
爲右對齊。:------
爲左對齊。:------:
爲居中對齊。-------
爲使用默認居中對齊。
1.9.2 示例
| 序號 | 交易名 | 交易說明 | 備註 | | ------: | :-------: | :--------- | ------ | | 1 | prfcfg | 菜單配置 | 可以通過此交易查詢到所有交易碼和菜單的對應關係 | | 2 | gentmo | 編譯所有交易 | | | 100000 | sysdba | 數據庫表模型彙總 | |
序號 | 交易名 | 交易說明 | 備註 |
---|---|---|---|
1 | prfcfg | 菜單配置 | 可以通過此交易查詢到所有交易碼和菜單的對應關係 |
2 | gentmo | 編譯所有交易 | |
100000 | sysdba | 數據庫表模型彙總 |
1.9.3 注意
- 每個Markdown解析器都不一樣,可能左右居中對齊方式的表示方式不一樣。
1.10 分割線
1.10.1 說明
使用---
或者***
或者* * *
表示水平分割線。
1.10.2 示例
--- *** * * *
1.10.3 注意
- 只要
*
或者-
大於等於三個就可組成一條平行線。 - 使用
---
作爲水平分割線時,要在它的前後都空一行,防止---
被當成標題標記的表示方式。
1.11 鏈接
1.11.1 說明
使用[](link "Optional title")
表示行內鏈接。其中:
[]
內的內容爲要添加鏈接的文字。link
爲鏈接地址。Optional title
爲顯示標題。顯示效果爲在你將鼠標放到鏈接上後,會顯示一個小框提示,提示的內容就是Optional title
裏的內容。
參考式鏈接如例所示。
1.11.2 示例
例1:行內鏈接
這就是我們常用的地址:[Baidu](www.baidu.com "百度一下,你就知道" )
這就是我們常用的地址:Baidu
例2:參考式鏈接
這就是我們常用的地址:[Baidu][1] [1]:www.baidu.com "百度一下,你就知道"
這就是我們常用的地址:Baidu
1.11.3 注意
- 參考式鏈接和行內鏈接的顯示效果是一樣的,但是在編輯狀態下的使用情況不一樣。行內連接緊跟鏈接文字,可以在看到鏈接文字的同時清楚的知道鏈接地址,但是不便於多次重複利用。參考式鏈接可以重複使用,但一般都是將一些鏈接放在一起統一管理,如一段文字後面或文章結尾,因此在找到鏈接和鏈接文字的對應關係上有些麻煩。各有利弊了,分情況使用。
- 使用場景很明瞭,不多說。
1.11 反斜槓
1.11.1 說明
使用\
表示反斜槓。在你不想顯示Markdown標記時可以使用反斜槓。
1.11.2 示例
\*這裏不會顯示斜體\*
*這裏不會顯示斜體*
1.11.3 注意
無。
1.12 空格
1.12.1 說明
Markdown語法會忽略首行開頭的空格,如果要體現出首行開頭空兩個的效果,可以使用全角符號下的空格,windows下使用shift+空格
切換。
1.12.2 示例
無。
1.12.3 注意
無。
2. 次常用標記
#### 2.1 標籤分類
2.1.1 說明
使用標籤:
或者Tags:
表示標籤標記。
2.1.2 示例
標籤: 數學 英語 Tags: 數學 英語
標籤: 數學 英語 Tags: 數學 英語
2.1.3 注意
標籤:
或者Tags:
的冒號要使用半角冒號。- 基本沒使用過這個標記,不過應用場景應該是歸類。便於快速瞭解文章分類。難道可以通過某種方式來遍歷到標籤標記?不甚瞭解。如你知道:請告訴我。
2.2 刪除線
2.2.1 說明
使用 ~~
表示刪除線。
2.2.2 示例
~~這是一條刪除線~~
這是一條刪除線
2.2.3 注意
- 注意
~~
和 要添加刪除線的文字之間不能有空格。 - 我常使用在顯示的告訴自己這行文字是要刪除的。
2.3 註腳
2.3.1 說明
使用 [^footer] 表示註腳。
2.3.2 示例
這是一個註腳測試[^footer1]。 [^footer1]: 這是一個測試,用來闡釋註腳。
這是一個註腳測試[^footer1]。
2.3.3 注意
- 我常在需要解釋一個名詞,或者一本書,或者一個人時使用腳註標記。
3. 不常用標記
3.1 實現頁內跳轉
3.1.1 說明
使用html代碼實現頁內跳轉。在要跳轉到的位置定義個錨<span id = "jump">hehe</span>
,然後使用[你好](#jump)
將你好
設置爲一單擊即跳轉到hehe
所在位置的效果。
3.1.2 示例
[你好](#jump) <span id = "jump">hehe</span>
你好 hehe
3.1.3 注意
無。
4. 專項使用標記
4.1 流程圖
以後在總結吧,現在的我完全沒有使用上,沒有需求就先不總結了。
4.2 LaTeX公式
以後在總結吧,現在的我完全沒有使用上,沒有需求就先不總結了。
寫在後面的話
- [TOC]不支持呀不支持,看不到效果了。
- 誰有什麼好的方式在博客園中更好的顯示Markdown,像作業部落一樣。
- 更好的Markdown閱讀效果:Markdown,你只需要掌握這幾個
以上都是我學習到的,然後經過幾個月的使用總結的,針對我的常用非常用分類。如果有描述的不對的地方,歡迎批評指正,共同進步。
---------------------