MarkDown簡明教程

簡介

MarkDown是一種輕量級標記語法,這種語法利用特殊的文本字符來標識某種樣式,讓寫作者在寫作的時候可以全身心的關注內容,而不需要太關心文章格式。當寫作完成後可以將MarkDown文件轉換成HTML、PDF、圖像、Epub等多種通用格式的文檔。可以說MarkDown是寫博客的利器。

比如說,MarkDown語法中使用兩個**來標識加粗的樣式。我們在書寫時只需要寫成

我是一段文本,這裡需要**加粗**。

經過MarkDown渲染後就是下面的效果

我是一段文本,這裡需要加粗

MarkDown由Aaron Swartz和John Gruber共同設計。Aaron Swartz就是那位在 2013年1月11日自殺,有着開掛一般人生經歷的程序員。維基百科對他的介紹是:軟件工程師、作家、政治組織者、互聯網活動家、維基百科人。

他有着足以讓你跪拜的人生經歷:

  • 14歲參與RSS 1.0規格標準的制訂。
  • 2004年入讀斯坦福,之後退學。
  • 2005年創建Infogami,之後與Reddit合併成為其合伙人。
  • 2010年創立求進會(Demand Progress),積极參与禁止網絡盜版法案(SOPA)活動,最終該提案被撤回。
  • 2011年7月19日,因被控從MIT和JSTOR下載480萬篇學術論文並以免費形式上傳於網絡被捕。
  • 2013年1月自殺身亡。

img

優點
使用Markdown有很多優勢。

  • Markdown這種標記語言可以非常方便的排版文章同事適配各大寫作網站,這種沉浸式的寫作體驗讓你專註於寫作而不是糾結於排版(想想word的寫作體驗);
  • Markdown是純文本的格式,比較輕量級,而且文本文件在各個平台(操作系統)上都能順利打開;
  • 可以非常方便地轉換成HTML、PDF、圖像、Epub等多種通用格式;
  • 和HTML一樣,Markdown也是一種標記語言,但是和HTML比起來,MarkDown更加易於書寫,可讀性也更高。

缺點

  • 由於MarkDown中的標記符號都是英文字符,所以如果你是用中文在寫作的話需要經常切換輸入法,比較麻煩。老外在設計MarkDown的時候只考慮到自己,有點「自私」,哈哈;
  • 支持的格式不夠全,MarkDown支持的格式沒有Word這種軟件那麼全。比如說原生MarkDown中的表格就不支持跨多行。

下面來介紹下MarkDown的簡明用法。

MarkDown語法

MarkDown的語法非常簡單,學習成本比較低。這也許也是MarkDown比較流行的一個原因。

標題語法

1、使用 = 和 – 標記一級和二級標題

我展示的是一級標題
=================

我展示的是二級標題
-----------------

但是這種格式的標題最多只能顯示兩級標題,平時我們用的比較多的還是下面介紹的#形式的標題。

2. 使用 # 號標記

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

段落字體語法

Markdown 段落沒有特殊的格式,直接編寫文字就好。段落的換行是使用兩個以上空格加上回車。你也可以使用一個空行來表示開啟一個新段落。

字體相關語法

*斜體文本*
_斜體文本_
**粗體文本**
__粗體文本__
***粗斜體文本***
___粗斜體文本___

顯示效果如下:

斜體文本
斜體文本
粗體文本
粗體文本
粗斜體文本
粗斜體文本

分割線相關語法

***
* * *
*****
- - -
----------

效果如下:






刪除線相關語法

如果段落上的文字要添加刪除線,只需要在文字的兩端加上兩個波浪線 ~~ 。

~~程序員自由之路~~

顯示效果如下:

程序員自由之路

下劃線語法

<u>程序員自由之路</u>

顯示效果如下:

程序員自由之路

標註語法

程序員自由之路[^slogan]

顯示效果如下:

程序員自由之路[1]

列表語法

無序列表使用星號(*)、加號(+)或是減號(-)作為列表標記

* 程序員自由之路1
+ 程序員自由之路2
- 程序員自由之路3

顯示效果

  • 程序員自由之路1
  • 程序員自由之路2
  • 程序員自由之路3

有序列表使用數字並加上 . 號來表示。

1. 程序員自由之路1
2. 程序員自由之路2
3. 程序員自由之路3

顯示效果如下

  1. 程序員自由之路1
  2. 程序員自由之路2
  3. 程序員自由之路3

有序列表和無序列表之間可以嵌套

1. 程序員1
    - 自由之路1
    - 自由之路2
2. 程序員2
	- 自由之路3
	- 自由之路4

顯示效果如下:

  1. 程序員1
    • 自由之路1
    • 自由之路2
  2. 程序員2
  • 自由之路3
  • 自由之路4

引用語法

MarkDown中使用>來表示引用。

> 事實表明,執着的程序員更容易成功~

顯示效果如下:

事實表明,執着的程序員更容易成功~

代碼語法

MarkDown中一般使用一對“`來表示代碼塊。同時在“`旁邊還可以指定代碼具體是屬於什麼語言。

“`java
public class Hello{
public static void main(String[] args){
System.out.println(“Hello World…”);
}
}
“`

顯示效果如下:

public class Hello{
    public static void main(String[] args){
        System.out.println("Hello World...");
    }
}

鏈接語法

MarkDown中鏈接的語法如下

[連接名稱](鏈接地址)
<連接地址>

顯示效果如下:

歡迎訪問我的個人網站程序員自由之路

歡迎訪問我的個人網站<www.chensongxia.cn>

MarkDown也支持文內跳轉語法,一般通過HTML標籤完成。

歡迎閱讀自由之路寫的代碼

圖片語法

MarkDown中的圖片語法如下

![alt 屬性文本](圖片地址)

![alt 屬性文本](圖片地址 "可選標題")

我們可以使用img標籤來使用更高級的圖片樣式。

<img src="line" width="50%" >

表格語法

MarkDown的表格語法如下:

|  表頭   | 表頭  |
|  ----  | ----  |
| 單元格  | 單元格 |
| 單元格  | 單元格 |

顯示效果如下:

表頭 表頭
單元格 單元格
單元格 單元格

我們可以設置表格的對齊方式:

  • -: 設置內容和標題欄居右對齊。
  • :- 設置內容和標題欄居左對齊。
  • :-: 設置內容和標題欄居中對齊。
| 左對齊 | 右對齊 | 居中對齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |

顯示效果如下:

左對齊 右對齊 居中對齊
單元格 單元格 單元格
單元格 單元格 單元格

HTML元素

目前MarkDown支持的HTML元素:<kbd> <b> <i> <em> <sup> <sub> <br>等。

參考


  1. 自由之路上我們攜手前行 ↩︎