Markdown,你只需要掌握這幾個

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 注意
  1. #和標題之間最好加一個空格。不要問我爲什麼,貌似有時候不會被識別爲標題?已經忘記自己爲什麼要加空格了,也許是任性。
  2. ====----表示標題時,大於等於2個都可以表示。
  3. 我通常在標題分級時使用標題標記,這個的用處很明瞭了。

1.2 目錄

1.2.1 說明

使用[TOC]生成目錄。如一開始的目錄所示。

1.2.2 示例
[TOC]

[TOC]

1.2.3 注意
  1. 如果你的標題都是按照Markdown語法書寫的話,可以自動生成層級目錄。
  2. 我常用 爲知筆記 記筆記,可惜爲知筆記不支持[TOC]標記,一個悲傷的故事。
  3. [TOC] 標記可能只能放在一級標題的前面,視不同的編譯器而定。

1.3 引用

1.3.1 說明

使用>表示引用,>>表示引用裏面再套一層引用,依次類推。

1.3.2 示例

例1:

> 這是一級引用
>>這是二級引用
>>> 這是三級引用

>這是一級引用

這是一級引用 這是二級引用 這是三級引用

這是一級引用

例2:

> 這是一級引用
>>這是二級引用
>>> 這是三級引用
>這是一級引用

這是一級引用 這是二級引用 這是三級引用 這是一級引用

1.3.3 注意
  1. 如果>>>嵌套使用的話,從>>退到>時,必須之間要加一個空格或者>作爲過渡,否則默認爲下一行和上一行是同一級別的引用。如示例所示。
  2. 引用標記裏可以使用其他標記,如:有序列表或無序列表標記,代碼標記等。
  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 注意
  1. `這個符號是在Esc鍵下面,切換到英文下即可。
  2. ```後面的javascript表示此段代碼爲javascript代碼,Markdown會自行使用javascript代碼顏色渲染。這裏也可以不寫。PS:誰能夠提供一個完整的Markdown可以渲染的語言列表啊,比如:linux命令這裏寫什麼?
  3. 本文檔所有使用講解Markdown語法標記示例的地方都是使用代碼塊標記的。

1.5 行內代碼

1.5.1 說明

使用``表示行內代碼。

1.5.2 示例
這是`javascript`代碼

這是javascript代碼

1.5.3 注意
  1. 本頁部分文字中間的英文字母就是使用行內代碼標記標記的。
  2. 這個的使用場景我也有些模糊。我常在文字間有英文的時候使用,但有時又不知道該不該使用,困擾。如果你知道,請告訴我。

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 注意
  1. 導入的圖片路徑可以使用絕對路徑也可以使用相對路徑,建議使用相對路徑。
  2. 我通常的做法是Markdown文檔的同級目錄下建立一個pictures文件夾,裏面放置所有所需的圖片,如果圖片多的話,你也可以在pictures文件夾裏建立子文件夾歸類。

1.7 列表

1.7.1 說明

使用1. 2. 3.表示有序列表,使用*-+表示無序列表。

1.7.2 示例

例1:有序列表

1. 第一點
2. 第二點
4. 第三點
  1. 第一點
  2. 第二點
  3. 第三點

例2:無序列表

+ 呵呵
    * 嘉嘉
    - 嘻嘻
    - 吼吼
        - 嘎嘎
        + 桀桀
* 哈哈
  • 呵呵
    • 嘉嘉
    • 嘻嘻
    • 吼吼
      • 嘎嘎
      • 桀桀
  • 哈哈
1.7.3 注意
  1. 無序列表或有序列表標記和後面的文字之間要有一個空格隔開。
  2. 有序列表標記不是按照你寫的數字進行顯示的,而是根據當前有序列表標記所在位置顯示的,如示例1所示。
  3. 無序列表的項目符號是按照實心圓、空心圓、實心方格的層級關係遞進的,如例2所示。通常情況下,同一層級使用同一種標記表示,便於自己查看和管理。
  4. 無序列表和有序列表標記的使用場景也很明瞭,故不多說。

1.8 粗體和斜體

1.8.1 說明

使用 ** 或者 __ 表示粗體。 使用 * 或者 _ 表示斜體。

1.8.2 示例
 **粗體1**    __粗體2__
 *斜體1*    _斜體2_

粗體1 粗體2 斜體1 斜體2

1.8.3 注意
  1. 前後的 * 或 _ 與要加粗或傾斜的字體之間不能有空格。
  2. 我通常在強調時使用加粗標記,在和一行中的加粗區分且也表示強調時使用傾斜標記,這裏的傾斜標記的使用場景不明確。如果你知道:請務必告訴我。

1.9 表格

1.9.1 說明

具體使用方式請看示例。

  • ------:爲右對齊。
  • :------爲左對齊。
  • :------:爲居中對齊。
  • -------爲使用默認居中對齊。
1.9.2 示例
|         序號    |    交易名    |    交易說明    |    備註    |
|    ------: |    :-------:    |    :---------   |    ------    |
|    1    |    prfcfg    |    菜單配置    |    可以通過此交易查詢到所有交易碼和菜單的對應關係    |
|    2    |    gentmo    |    編譯所有交易    |    |
|    100000    |    sysdba    |    數據庫表模型彙總    |    |

序號

交易名

交易說明

備註

1

prfcfg

菜單配置

可以通過此交易查詢到所有交易碼和菜單的對應關係

2

gentmo

編譯所有交易

100000

sysdba

數據庫表模型彙總

1.9.3 注意
  1. 每個Markdown解析器都不一樣,可能左右居中對齊方式的表示方式不一樣。

1.10 分割線

1.10.1 說明

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

1.10.2 示例
---

***

* * *



1.10.3 注意
  1. 只要*或者-大於等於三個就可組成一條平行線。
  2. 使用---作爲水平分割線時,要在它的前後都空一行,防止---被當成標題標記的表示方式。

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. 參考式鏈接和行內鏈接的顯示效果是一樣的,但是在編輯狀態下的使用情況不一樣。行內連接緊跟鏈接文字,可以在看到鏈接文字的同時清楚的知道鏈接地址,但是不便於多次重複利用。參考式鏈接可以重複使用,但一般都是將一些鏈接放在一起統一管理,如一段文字後面或文章結尾,因此在找到鏈接和鏈接文字的對應關係上有些麻煩。各有利弊了,分情況使用。
  2. 使用場景很明瞭,不多說。

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 注意
  1. 標籤:或者Tags:的冒號要使用半角冒號。
  2. 基本沒使用過這個標記,不過應用場景應該是歸類。便於快速瞭解文章分類。難道可以通過某種方式來遍歷到標籤標記?不甚瞭解。如你知道:請告訴我。

2.2 刪除線

2.2.1 說明

使用 ~~表示刪除線。

2.2.2 示例
~~這是一條刪除線~~

這是一條刪除線

2.2.3 注意
  1. 注意 ~~ 和 要添加刪除線的文字之間不能有空格。
  2. 我常使用在顯示的告訴自己這行文字是要刪除的。

2.3 註腳

2.3.1 說明

使用 [^footer] 表示註腳。

2.3.2 示例
這是一個註腳測試[^footer1]。

[^footer1]: 這是一個測試,用來闡釋註腳。

這是一個註腳測試[^footer1]。

2.3.3 注意
  1. 我常在需要解釋一個名詞,或者一本書,或者一個人時使用腳註標記。

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公式

以後在總結吧,現在的我完全沒有使用上,沒有需求就先不總結了。


寫在後面的話

以上都是我學習到的,然後經過幾個月的使用總結的,針對我的常用非常用分類。如果有描述的不對的地方,歡迎批評指正,共同進步。

--------------------- 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章