題記
為什么使用Markdown?這是一個問題。答案有很多種。比如,不局限於格式啦,比如.xls
文檔得用excel打開吧,.doc
文檔得用word打開吧,.xxx
得用xxx打開吧。如果你機子上沒有這個軟件,豈不是抓瞎了,還能不能愉快的學習了?!因此你需要一種能使用簡單的文本編輯器就可以書寫,有瀏覽器就可正常顯示的格式或標記,Markdown很適合哦。什么,這個理由不好?那么就權當是裝B吧,你說你用Markdown寫文檔,是不是逼格一下就上去了。(哎,估計也只有我這種新手才用來炫耀,大牛都是不屑的。)
正文
二八定律說:
百分之二十的知識解決百分之八十的問題。
其實你只需要掌握基本語法標記就可以愉快的玩耍了。經過幾個月使用Markdown寫文檔,發現掌握下面這些標記語法,就可以完成日常文檔書寫了。什么?要畫流程圖?這些需求對於大部分時間來說,你是用不到的,你只需要建立一個知識儲備就好。遇到了想不起來?打開看一下就是了。想記住?對不起,這種事倍功半的事情,還是少做為妙,畢竟時間是硫酸,管你是什么都能夠腐化,只是快慢而已。
那么問題來了,為什么這幾個常用的要記住呢?因為這幾個是經常使用的,雖然熟能生巧,日久便記住了,但是在熟能生巧的路上總不能天天翻看知識儲備吧。太影響效率。何不花一點點時間強行記住,那么在日久記住的道路上,豈不是一路順風?閑話不多說,來看看你要掌握的語法標記吧。如果你想學習和使用Markdown,我建議:
- __常用標記__要先花一些時間熟記,后面經常使用的話就會形成習慣了,不過腦的正常書寫,跟打字一樣;
- __次常用標記__要有基本的印象,能記住也是可以的;
- __不常用標記__和專用標記just看看就好,等到使用的時候百度一下,你就知道。
1. 常用標記
1.1 標題
1.1.1 說明
- 使用
#
表示標題,一級標題使用一個#
,二級標題使用兩個##
,以此類推,共有六級標題。 - 使用
=====
表示高階標題,使用---------
表示次階標題。
1.1.2 示例
# 這是一級標題
## 這是二級標題
### 這是三級標題
###### 這是六級標題
這是高階標題(效果和一級標題一樣 )
========
這是次階標題(效果和二級標題一樣)
--------------
這是一級標題
這是二級標題
這是三級標題
這是六級標題
這是高階標題(效果和一級標題一樣 )
這是次階標題(效果和二級標題一樣)
1.1.3 注意
#
和標題之間最好加一個空格。不要問我為什么,貌似有時候不會被識別為標題?已經忘記自己為什么要加空格了,也許是任性。====
和----
表示標題時,大於等於2個都可以表示。- 我通常在標題分級時使用標題標記,這個的用處很明了了。
1.2 目錄
1.2.1 說明
使用[TOC]
生成目錄。如一開始的目錄所示。
1.2.2 示例
[TOC]
1.2.3 注意
- 如果你的標題都是按照Markdown語法書寫的話,可以自動生成層級目錄。
- 我常用 為知筆記 記筆記,可惜為知筆記不支持
[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
為顯示標題。顯示效果為在你將鼠標放到圖片上后,會顯示一個小框提示,提示的內容就是Optional title
里的內容。
1.6.2 示例

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]: 這是一個測試,用來闡釋注腳。
這是一個注腳測試[1]。
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公式
以后在總結吧,現在的我完全沒有使用上,沒有需求就先不總結了。
寫在后面的話
- 誰有什么好的方式在博客園中更好的顯示Markdown,像作業部落一樣。
- 更好的Markdown閱讀效果:Markdown,你只需要掌握這幾個
以上都是我學習到的,然后經過幾個月的使用總結的,針對我的常用非常用分類。如果有描述的不對的地方,歡迎批評指正,共同進步。
這是一個測試,用來闡釋注腳。 ↩︎