Markdown使用教程


什么是Markdown語言

Markdown是一門如同HTML一樣的標記語言。它使用一些簡單的標記來展現文檔的不同格式,例如,本章節的標題我們就是使用這樣的格式表示的:

# 什么是Markdown語言

這個展現出來的就是本章的標題。

為什么使用Markdown語言

  • 樣式豐富
    使用Markdown語言,可以使文檔擁有豐富的展現形式,各種不同的格式,十分適用於博客,文檔等使用場景。
  • 簡單易學
    通過上一節的例子我們會發現,Markdown語言明顯比其他標記語言,如HTML,簡單易學。在HTML中寫標題樣式是這樣的:
<h1>什么是Markdown語言</h1>

可以很容易的看出比Markdown麻煩很多——Markdown只需要多一個字符就可以展示為標題,而HTML需要9個。
另外,Markdown也比HTML易學很多。HTML的教程動輒幾百頁,而Markdown只要一篇簡短的教程就能搞定。

  • 版本控制友好
    如果只是因為有豐富的格式樣式的話,我們為什么不選擇Word呢?這里有兩個原因。其中之一就是版本控制友好。(另一個原因是有很多在線編輯平台支持Markdown,但並不支持Word。)
    一般的版本控制系統都是基於文件字符的,而Word使用的是一種特殊的編碼格式。因此,當你使用版本控制工具比對Word文件的版本的時候,你其實能夠看到的只是一堆亂碼。而如果你要去對比Markdown的文檔時,則可以看到非常清晰的版本對比信息。
    Markdown語言的版本對比十分清晰
  • 使用廣泛
    大多數的博客系統,如簡書,wordpress等;和很多技術社區及文檔平台,如github,圖靈社區等都支持wordpress編輯模式。學會Markdown就可以讓我們在這些平台上更容易地編輯出漂亮的文檔。

在哪里實戰操作

我們學習一個語言最好的方式就是實戰。那么我們學習markdown語言要去哪里實戰呢?您可以在網上搜索Markdown在線編輯器,一般這種編輯器都是左邊寫Markdown,右邊就時時把樣式展現出來的,十分方便。這樣您就可以邊看教程,邊練習了。

語法

換行

Markdown中最基本的語法就是換行。在標准的Markdown中,輸入一個回車是起不到換行的效果的:

第一行
第二行

在標准的Markdown中,這樣的文本顯示出來的是:

第一行 第二行

如果我想換行就必須在每行的末尾加兩個空格,或使用兩個回車起到換行的效果(兩個回車的換行在展示中也會多一行)。
不過,很多平台,如簡書,都支持一個回車直接換行。但是為了確保編寫的Markdown有最好的兼容性。還是建議使用標准的Markdown語法進行換行。

標題

標題也是個十分常用的語法。Markdown中最多支持六級標題:

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

需要注意的是,標准的格式是 井號+空格+標題。有些Markdown編輯器支持井號后邊不加空格也可以,但那是不標准的語法。

加粗

加粗語法一般有兩種:

這樣可以**加粗**。
這樣也可以 __加粗__ 。

這樣可以加粗
這樣也可以 加粗

加粗的兩種語法分別是前后加兩個星號,或前后加兩個下划線。需要注意的是,前后加兩個下划線的寫法,在標准的Markdown語法中是要前后加空格的。當然依舊有些編輯器可以省略前后的空格。

斜體

斜體語法一般也有兩種:

這樣可以*斜體*。
這樣也可以 _斜體_ 。

這樣可以斜體
這樣可以 斜體

斜體的兩種語法分別是前后加一個星號,或前后加一個下划線。需要注意的是,前后加一個下划線的寫法,在標准的Markdown語法中是要前后加空格的。當然依舊有些編輯器可以省略前后的空格。

刪除線

如果我們想明確的表達,不要某句話了或不要這么做,我們可以使用刪除線:

~~我要刪掉這個。~~

我要刪掉這個。

刪除線的寫法就是前后加兩個波浪號。

引用

如果我們想引用一段文字我們可以這樣:

>黃鳥於飛,
>集於灌木,
>其鳴喈喈。

黃鳥於飛,
集於灌木,
其鳴喈喈。

使用引用,就是在你引用的文字前邊加上小於號。

引用代碼

引用代碼分為兩種模式,一種是行內引用,一種是多行引用。
我們先來說行內引用:
使用'public static void main()'來聲明入口函數。
使用public static void main()來聲明入口函數。
我們在要引用的代碼前后都加一個撇號就可以在行內引用代碼了 。
我們再來說引用多行代碼的方法:
'''
public static void main(){

}
'''

public static void main(){

}

引用多行代碼的方式就是在代碼上下分別加三個撇號。

列表

列表一般有兩種情況,一種是無序列表,一種是有序列表。
使用無序列表的方法如下:

- 列表
- 列表
- 列表
  • 列表
  • 列表
  • 列表

無序列表的使用方式是,減號+空格+文字。空格務必不能丟掉。
有序列表的使用只是把減號換成了數字標號:

1. 列表
2. 列表
3. 列表
  1. 列表
  2. 列表
  3. 列表

有序列表的語法是 編號+點+空格+文字。也許你會奇怪,這樣寫有什么意義呢。
那我們換一種寫法。

1. 列表
1. 列表
1. 列表
  1. 列表
  2. 列表
  3. 列表

你會發現,它展現的還是123。
除了無序列表和有序列表,列表還有一個概念就是多級列表:

- 一級列表
一級列表內容
  - 二級列表
二級列表內容
    - 三級列表
三級列表內容
  • 一級列表
    一級列表內容
    • 二級列表
      二級列表內容
      • 三級列表
        三級列表內容

只需要在列表前邊加個tab就可以了。

鏈接

下面為大家介紹如何使用Markdown加入鏈接:

這是百度的[鏈接](http://www.baidu.com.cn)

這是百度的鏈接
這是最普通的加入鏈接的方式,中括號內是會觸發鏈接的文字,小括號內是鏈接的地址。
還有一種頁內鏈接,可以跳轉到指定的標題:

跳到加粗的鏈接:[鏈接](#加粗)

跳到加粗的鏈接:鏈接
只要在寫鏈接的小括號中寫上 井號+標題,即可。但是有的Markdown編輯器對頁內鏈接功能支持並不友好,比如簡書。
當然,鏈接還支持相對路徑鏈接。

表格

表格的寫法如下:

|表頭一|表頭二|表頭三|
|-|-|-|
|內容一|內容二|內容三|
|內容一二三|內容四五六|內容七八九|
表頭一 表頭二 表頭三
內容一 內容二 內容三
內容一二三 內容四五六 內容七八九

表格也可以設置左對齊,右對齊和居中:

|左對齊|右對齊|居中|
|:-|-:|:-:|
|內容一|內容二|內容三|
|內容一二三|內容四五六|內容七八九|
左對齊 右對齊 居中
內容一 內容二 內容三
內容一二三 內容四五六 內容七八九

引入圖片

引入圖片的方法如下:

![百度Logo](http://www.baidu.com/img/baidu_jgylogo3.gif)

百度Logo
嘆號開頭,中括號中為圖片的alt,小括號中為圖片的地址。

以上就是標准Markdown語言的基本用法。Markdown在不同的平台中還有不同的功能拓展,大家可以在使用那些平台的時候再去查閱相關的幫助文檔。


免責聲明!

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



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