1. 程式人生 > >markdown 入門教程(完整版)

markdown 入門教程(完整版)

圖片文字

Markdown是一種可以使用普通文字編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文字內容具有一定的格式。

1. 標題

Markdown支援6種級別的標題,對應html標籤 h1 ~ h6

# h1
## h2
### h3
#### h4
##### h5
###### h6

效果如下:

h1

h2

h3

h4

h5
h6

除此之外,Markdown還支援另外一種形式的標題展示形式,其類似於 Setext 標記語言的表現形式,使用下劃線進行文字大小的控制

這是一級標題
===
這是二級標題
---

效果如下:
這是一級標題
===
這是二級標題
---

2. 段落及區塊引用

Markdown提供了一個特殊符號 > 用於段首進行強調。

效果如下:

這段文字將被強調顯示...

3. 插入連結或圖片

  • 插入連結語法
[點選跳轉至百度](http://www.baidu.com)

效果如下:
點選跳轉至百度

  • 插入圖片語法
    ![圖片文字](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1546443532186&di=0196f0fd194c908499ec43c2e8d7c891&imgtype=0&src=http%3A%2F%2Fn1.itc.cn%2Fimg8%2Fwb%2Frecom%2F2016%2F06%2F02%2F146485608351068254.JPEG)

效果如下:

4.列表

Markdown支援有序列表和無序列表兩種形式:

  • 無序列表使用*或+或-標識
  • 有序列表使用數字加.標識,例如:1.
- java
- c++
- c

+ java
+ c++
+ c

- java
- c++
- c

1. java
2. c++
3. c

5. 分隔線

有時候,為了排版漂亮,可能會加入分隔線。Markdown加入分隔線非常簡單,使用下面任意一種形式都可以

* * *
- - -

效果如下:


6. 強調

有時候,我們希望對某一部分文字進行強調,使用*或_包裹即可。使用單一符號標記的效果是斜體,使用兩個符號標記的效果是加粗

*這裡是斜體*
_這裡是斜體_

**這裡是加粗**
__這裡是加粗__

效果如下:
這裡是斜體
這裡是斜體

這裡是加粗
這裡是加粗

7.插入行內程式碼及程式碼塊

Markdown在IT圈子裡面比較流行的一個重要原因是,它能夠輕鬆漂亮地插入程式碼。

  • 行內程式碼語法
`行內程式碼`

效果如下:
行內程式碼

  • 程式碼塊語法

效果如下:

fun (x: Int, y: Int): Int {
  return x + y
}

注:很多人不知道怎麼輸入反引號。在英文模式下,找到鍵盤最左側esc鍵下面的第一個鍵點選即可。

8.插入表格

格是Markdown語法中比較複雜的一個,其語法如下:

列一|列二|列三
:---|:---:|---:
0|0|0
2|2|2
列一 列二 列三
0 0 0
2 2 2

注:三個短斜槓左右的冒號用於控制對齊方式,只放置左邊冒號表示文字居左,只放置右邊冒號表示文字居右,如果兩邊都放置冒號表示文字居中。

9. 特殊符號處理

Markdown使用反斜槓\插入語法中用到的特殊符號。在Markdown中,主要有以下幾種特殊符號需要處理:

\   反斜線
`   反引號
*   星號
_   底線
{}  花括號
[]  方括號
()  括弧
#   井字號
+   加號
-   減號
.   英文句點
!   驚歎號

例如,如果你需要插入反斜槓,就連續輸入兩個反斜槓即可:\ =>  。

注:在內容中輸入以上特殊符號的時候一定要注意轉義,否則將導致內容顯示不全,甚至排版混亂。

如何給文字上色

使用Markdown的同學最鬱悶的地方恐怕就是不能給文字新增顏色了。事實上,Markdown的最初目標就是為純寫作而生的。因此,它並沒有考慮文字顏色這一點。所以,單純使用Markdown設定文字顏色已經做不到了。但你可以這樣做:

  • 先用Markdown編輯完成
  • 匯出為html,在需要上色的部分手動新增標籤<font color='#ff0000'></font>儲存即可。

Markdown編寫工具推薦

簡單總結

Markdown是一門比html更簡單的標記語言,其主要用於日常寫作。最終通過相應的編輯器或者指令碼轉換成html用於頁面渲染。如果你是一個作家,或者是一個程式設計師,Markdown對你來說是一門必備的技能。掌握Markdown真的很簡單,如你所見,這篇文章使用了這麼短的篇幅就已經將Markdown的語法全部介紹完了。
不過,由於Markdown基礎語法的限制,出現了一些針對Markdown語法的加強版本。它支援的語法特性更多,但這不是我們這篇文章的討論範圍。如果你希望快速掌握Markdown,很簡單,動起來吧!

連結:https://www.jianshu.com/p/335db5716248