天天看點

markdown引入代碼_一看就懂的Markdown入門文法筆記(整理自Markdown cheat sheet)

markdown引入代碼_一看就懂的Markdown入門文法筆記(整理自Markdown cheat sheet)

前言

最近在重新學習Markdown文法,打算用在筆記和部落格中。在網上找到了一篇很不錯的英文Markdown入門教程,從标題、強調到代碼高亮和圖檔超連結等方方面面的常用文法都覆寫到了。現在将它整理成中文分享出來,文後提供了原教程連結。

一、标題

一級标題

# 一級标題

二級标題

## 二級标題

三級标題

### 三級标題

單行分割線二級标題

單行分割線二級标題

---

雙行分割線一級标題

雙行分割線一級标題

===

二、強調

markdown引入代碼_一看就懂的Markdown入門文法筆記(整理自Markdown cheat sheet)

知乎編輯器不支援md樣式的删除線,是以在此使用了圖檔,源代碼:~~删除線~~

斜體 或 斜體:

_斜體_ 或 *斜體*

加粗

加粗

__加粗__ 或 **加粗**

三、清單

  • 對于如下這個Markdown清單樣式:
markdown引入代碼_一看就懂的Markdown入門文法筆記(整理自Markdown cheat sheet)

知乎不支援子清單的縮進,圖為Typora編輯器中的清單實際渲染效果

  • 其源代碼如下:
1. 有序清單
2. 另一行有序清單
    - 另一行子清單 (減号)
    * 無序号子清單 (星号)
    + 第三種子清單的寫法 (加号)
           

四、連結

1. 内聯超連結:

  • 方括号裡是超連結文字 [文字] ,緊跟着的圓括号裡是URL (URL)
  • 這是一個内聯超連結
  • 源代碼:
[這是一個内聯超連結](http://www.google.com)
           

2. 引用超連結

2.1. 前一對方括号内是文字顯示内容,後一對方括号表示引用的URL,例如

[文字][URL]

。同時在段落底部建立綁定

[URL]: xxx

,名字要與第二對方括号裡的内容相同

  • 這是一個[文字][URL]式的引用超連結
  • 源代碼:
[這是一個[文字][URL]式的引用超連結][URL_2]
[URL_2]: http://www.google.com
           

2.2. 用數字标号同樣可以綁定URL,例如

[1]: xxx
  • 這是一個用數字标号綁定URL的超連結
  • 源代碼:
[這是一個用數字标号綁定URL的超連結][1]
[1]: http://www.qq.com
           

2.3. 可以隻用一對方括号,展示URL文字内容

[文字]

,在段落底用相同的内容綁定URL

[文字]: xxx
  • 這是一個隻用到一對方括号的超連結
  • 源代碼:
[這是一個隻用到一對方括号的超連結]
[這是一個隻用到一對方括号的超連結]: http://www.zhihu.com
           

3. 插入超連結最簡單的方式

  • 尖括号裡的URL可以直接轉換成超連結 :http://www.wikipedia.org
  • 源代碼:
<http://www.wikipedia.org>
           

五、圖檔

1. 内聯樣式

  • 格式:![alt_text](address title_str)
  • 各參數含義: alt_text:圖檔無法被加載時作為備選項顯示的文字 address:圖床中的圖檔位址, title_str:滑鼠懸浮時的顯示的圖檔标題文字字元串,用雙引号包圍,與位址之間用空格隔開
  • 例如在Markdown中插入這樣一幅圖檔:
markdown引入代碼_一看就懂的Markdown入門文法筆記(整理自Markdown cheat sheet)
  • 其對應的源代碼為 :
![無法加載圖檔](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "這是圖檔标題")
           

可以将滑鼠懸浮在圖檔上,看到提示文字的确為“這是圖檔标題”。

2. 引用樣式

  • 格式:![alt_text][logo] 其中logo是在段落底部建立的與圖檔位址及标題的綁定: [logo]: address title_str
  • 用引用樣式來插入與内聯一例中相同的圖檔:
markdown引入代碼_一看就懂的Markdown入門文法筆記(整理自Markdown cheat sheet)
  • 其對應的源代碼為:
![無法加載圖檔][pic]

[pic]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "這是圖檔标題"
           

六、代碼塊

1. 代碼高亮

  • 用重音符 ` 這個符号來包圍想要高亮顯示的代碼塊:

bar, foo

  • 源代碼為:
`bar, foo`
           

2. 插入多行代碼塊

  • 用三個連續的重音符

    ```

    來引入接下來的一行或多行代碼塊,并同樣使用

    ```

    來表示代碼塊到此為止。可以在第一行中給出代碼使用的具體語言。例如:
# 這是在markdown中插入的python代碼塊
for i in range(10)
    print i
           
  • 對應的源代碼為:
```python 
# 這是在markdown中插入的python代碼塊
for i in range(10) 
print i
``` 
           

七、表格

1. 行列的分隔符

  • 用一個管道符号

    |

    用于分割列;用一個或多個短劃線

    -

    用于分割行。例如:
Markdown | Less |Pretty
- | - | -
*Still* | `renders` | **nicely**
1 | 2 | 3
           
  • 在Markdown中被渲染成:
markdown引入代碼_一看就懂的Markdown入門文法筆記(整理自Markdown cheat sheet)

知乎不支援在編輯中插入表格,圖為Typora編輯器中的表格實際渲染效果

2. 單元格對齊方式

  • 可以用冒号

    :

    在短劃線兩旁來辨別表格單元格的對齊方式。
    • 在短劃線右邊表明右對齊:

      ---:

    • 在短劃線左邊表明右對齊:

      :---

    • 兩邊都有表示居中對齊:

      :---:

  • 例如:
markdown引入代碼_一看就懂的Markdown入門文法筆記(整理自Markdown cheat sheet)

知乎不支援在編輯中插入表格,圖為Typora編輯器中的表格實際渲染效果

  • 對應的源代碼為:
| Markdown中 | 表格的表示方法        | 非常有趣:)  |
| -----------|:-------------------:| ------------:|
| 第3列是     | 右對齊              | $1600        |
| 第2列是     | 居中對齊            |   $12        |
| 短橫線可以   | 根據單元格内字元長短 |    任意增删   |
           

八、引用塊

1. 格式

  • 用右尖括号

    >

    引入一段引文,markdown可以根據字元長短在渲染時恰當地處理換行。
  • 例如:

這是一段引文

這是新行中的一段引文,與上文同屬一個引用塊

盡管已經換了新行,隻要中間沒有被空行隔斷,渲染時它們會顯示為同一個引文塊

現在被隔斷了

這是一段非常長、極其長、長得不可思議的引文,這段引文的奧秘在于:盡管它又臭又長,但是在markdown視圖下依然會被正确地渲染并顯示,因為markdown可以根據字元數目自動換行,到這裡為止依然是同一行原文:)

  • 源代碼如下:
> 這是一段引文
>
> 這是新行中的一段引文,與上文同屬一個引用塊
> 盡管已經換了新行,隻要中間沒有被空行隔斷,渲染時它們會顯示為同一個引文塊

> 現在被隔斷了
> 這是一段非常長、極其長、長得不可思議的引文,這段引文的奧秘在于:盡管它又臭又長,但是在markdown視圖下依然會被正确地渲染并顯示,因為markdown可以根據字元數目在渲染時自動換行,到這裡為止依然是同一段引文:)
           

參考連結

https://github.com/adam-p/markdown-here/wiki/Markdown-Here-Cheatsheet​github.com