Markdown,你只需要掌握這幾個


題記

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

1.2 目錄

1.2.1 說明

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

1.2.2 示例
[TOC]

1.2.3 注意
  1. 如果你的標題都是按照Markdown語法書寫的話,可以自動生成層級目錄。
  2. 我常用 為知筆記 記筆記,可惜為知筆記不支持
  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](https://images0.cnblogs.com/blog/404392/201501/122257231047591.jpg)

Markdown

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]: 這是一個測試,用來闡釋注腳。

這是一個注腳測試[1]

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

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


寫在后面的話

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


  1. 這是一個測試,用來闡釋注腳。 ↩︎


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM