測試markdown

目錄html


author: Demi_YuHongJun
comments: true
date: 2017-05-02 09:42:32+00:00
layout: post
title: Markdown 語法手冊 (完整整理版)
description: Markdown 語法手冊 (完整整理版)
keywords: Markdown,Tech
flowchart: true
categories:git

  • Tech
    tags:
  • Markdown

  • 目錄
    {:toc}
    ---程序員

    1. 斜體和粗體

*斜體*或_斜體_
**粗體**
***加粗斜體***
~~刪除線~~

viewgithub

斜體或_斜體_shell

粗體canvas

加粗斜體markdown

刪除線app


2. 分級標題

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

因爲用了標記編輯器會把全部標題寫到目錄大綱中,在這裏寫的演示標題也會列進去,因此就不演示了。同窗們本身在編輯器中觀察,很簡單,一級標題字號最大,依級遞減。編輯器


3. 超連接

Markdown 支持兩種形式的連接語法: 行內式和參考式兩種形式,行內式通常使用較多。ide

3.1. 行內式

語法說明:

[]裏寫連接文字,()裏寫連接地址, ()中的」「中能夠爲連接指定title屬性,title屬性可加可不加。title屬性的效果是鼠標懸停在連接上會出現指定的 title文字。連接地址與連接標題前有一個空格。

歡迎來到[Demi的隨筆和技術空間](https://yuhongjun.github.io/)

歡迎來到[Demi的隨筆和技術空間](https://yuhongjun.github.io/ "Demi的隨筆和技術空間")

view

歡迎來到Demi的隨筆和技術空間

歡迎來到Demi的隨筆和技術空間

3.2. 參考式

參考式超連接通常用在學術論文上面,或者另外一種狀況,若是某一個連接在文章中多處使用,那麼使用引用 的方式建立連接將很是好,它可讓你對連接進行統一的管理。

語法說明:
參考式連接分爲兩部分,文中的寫法 [連接文字][連接標記],在文本的任意位置添加[連接標記]:連接地址 「連接標題」,連接地址與連接標題前有一個空格。

若是連接文字自己能夠作爲連接標記,你也能夠寫成[連接文字][]
[連接文字]:連接地址的形式,見代碼的最後一行。

我常常去的幾個網站[Google][1],[Demi的隨筆和技術空間][2],[Demi的隨筆和技術空間][]。

[1]:http://www.google.com
[2]:https://yuhongjun.github.io/ "Demi的隨筆和技術空間"
[Demi的隨筆和技術空間]:https://yuhongjun.github.io/

我常常去的幾個網站Google,Demi的隨筆和技術空間,Demi的隨筆和技術空間

3.3. 自動連接

語法說明:
Markdown 支持以比較簡短的自動連接形式來處理網址和電子郵件信箱,只要是用<>包起來, Markdown 就會自動把它轉成連接。通常網址的連接文字就和連接地址同樣,例如:

<http://example.com/>
<address@example.com>

view

http://example.com/
address@example.com


4. 錨點

網頁中,錨點其實就是頁內超連接,也就是連接本文檔內部的某些元素,實現當前頁面中的跳轉。好比我這裏寫下一個錨點,點擊回到目錄,就能跳轉到目錄。 在目錄中點擊這一節,就能跳過來。還有下一節的註腳。這些根本上都是用錨點來實現的。

注意:

  1. Markdown Extra 只支持在標題後插入錨點,其它地方無效。
  2. Leanote 編輯器右側顯示效果區域暫時不支持錨點跳轉,因此點來點去發現沒有跳轉沒必要驚慌,可是你發佈成筆記或博文後是支持跳轉的。
## 0. 跳轉測試{#index}

跳轉到[跳轉測試](#index)

5. 列表

5.1. 無序列表

使用 *,+,- 表示無序列表。

- 無序列表項 一
- 無序列表項 二
- 無序列表項 三

view

  • 無序列表項 一
  • 無序列表項 二
  • 無序列表項 三
5.2. 有序列表

有序列表則使用數字接着一個英文句點。

1. 有序列表項 一
2. 有序列表項 二
3. 有序列表項 三

view

  1. 有序列表項 一
  2. 有序列表項 二
  3. 有序列表項 三
5.3. 定義型列表

語法說明:

定義型列表由名詞和解釋組成。一行寫上定義,緊跟一行寫上解釋。解釋的寫法:緊跟一個縮進(Tab)

代碼塊 1 Markdown
:    輕量級文本標記語言,能夠轉換成html,pdf等格式(左側有一個可見的冒號和四個不可見的空格)

代碼塊 2
:   這是代碼塊的定義(左側有一個可見的冒號和四個不可見的空格)

        代碼塊(左側有八個不可見的空格)

view

代碼塊 1 Markdown
: 輕量級文本標記語言,能夠轉換成html,pdf等格式(左側有一個可見的冒號和四個不可見的空格)

代碼塊 2
: 這是代碼塊的定義(左側有一個可見的冒號和四個不可見的空格)

代碼塊(左側有八個不可見的空格)
5.3. 列表縮進

語法說明:

列表項目標記一般是放在最左邊,可是其實也能夠縮進,最多 3 個空格,項目標記後面則必定要接着至少一個空格或製表符。

*   輕輕的我走了, 正如我輕輕的來; 我輕輕的招手, 做別西天的雲彩。
那河畔的金柳, 是夕陽中的新娘; 波光裏的豔影, 在個人心頭盪漾。 
軟泥上的青荇, 油油的在水底招搖; 在康河的柔波里, 我甘心作一條水草! 
*   那榆蔭下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻間, 沉澱着彩虹似的夢。 
尋夢?撐一支長篙, 向青草更青處漫溯; 滿載一船星輝, 在星輝斑斕裏放歌。 
但我不能放歌, 悄悄是別離的笙簫; 夏蟲也爲我沉默, 沉默是今晚的康橋! 
悄悄的我走了, 正如我悄悄的來; 我揮一揮衣袖, 不帶走一片雲彩。

view

  • 輕輕的我走了, 正如我輕輕的來; 我輕輕的招手, 做別西天的雲彩。
    那河畔的金柳, 是夕陽中的新娘; 波光裏的豔影, 在個人心頭盪漾。
    軟泥上的青荇, 油油的在水底招搖; 在康河的柔波里, 我甘心作一條水草!
  • 那榆蔭下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻間, 沉澱着彩虹似的夢。
    尋夢?撐一支長篙, 向青草更青處漫溯; 滿載一船星輝, 在星輝斑斕裏放歌。
    但我不能放歌, 悄悄是別離的笙簫; 夏蟲也爲我沉默, 沉默是今晚的康橋!
    悄悄的我走了, 正如我悄悄的來; 我揮一揮衣袖, 不帶走一片雲彩。
5.4. 包含段落的列表

語法說明:

列表項目能夠包含多個段落,每一個項目下的段落都必須縮進 4 個空格或是 1 個製表符(顯示效果與代碼一致):

*   輕輕的我走了, 正如我輕輕的來; 我輕輕的招手, 做別西天的雲彩。
那河畔的金柳, 是夕陽中的新娘; 波光裏的豔影, 在個人心頭盪漾。 
軟泥上的青荇, 油油的在水底招搖; 在康河的柔波里, 我甘心作一條水草!

     那榆蔭下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻間, 沉澱着彩虹似的夢。 
尋夢?撐一支長篙, 向青草更青處漫溯; 滿載一船星輝, 在星輝斑斕裏放歌。 
但我不能放歌, 悄悄是別離的笙簫; 夏蟲也爲我沉默, 沉默是今晚的康橋!

*    悄悄的我走了, 正如我悄悄的來; 我揮一揮衣袖, 不帶走一片雲彩。

view

  • 輕輕的我走了, 正如我輕輕的來; 我輕輕的招手, 做別西天的雲彩。
    那河畔的金柳, 是夕陽中的新娘; 波光裏的豔影, 在個人心頭盪漾。
    軟泥上的青荇, 油油的在水底招搖; 在康河的柔波里, 我甘心作一條水草!

    那榆蔭下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻間, 沉澱着彩虹似的夢。
    尋夢?撐一支長篙, 向青草更青處漫溯; 滿載一船星輝, 在星輝斑斕裏放歌。
    但我不能放歌, 悄悄是別離的笙簫; 夏蟲也爲我沉默, 沉默是今晚的康橋!

  • 悄悄的我走了, 正如我悄悄的來; 我揮一揮衣袖, 不帶走一片雲彩。

5.5. 包含引用的列表

語法說明:

若是要在列表項目內放進引用,那 > 就須要縮進:

*   閱讀的方法:
    > 打開書本。
    > 打開電燈。

view

  • 閱讀的方法:

    打開書本。
    打開電燈。

5.6. 包含代碼區塊的引用

語法說明:
若是要放代碼區塊的話,該區塊就須要縮進兩次,也就是 8 個空格或是 2 個製表符:

5.7. 一個特殊狀況

在特殊狀況下,項目列表極可能會不當心產生,像是下面這樣的寫法:

1986. What a great season.

會顯示成:

  1. What a great season.

換句話說,也就是在行首出現數字-句點-空白,要避免這樣的情況,你能夠在句點前面加上反斜槓:

1986\. What a great season.

纔會正常顯示成:

1986. What a great season.


6. 引用

語法說明:

引用須要在被引用的文本前加上>符號。

> 這是一個有兩段文字的引用,
無心義的佔行文字1.
無心義的佔行文字2.

> 無心義的佔行文字3.
無心義的佔行文字4.

view

這是一個有兩段文字的引用,
無心義的佔行文字1.
無心義的佔行文字2.

無心義的佔行文字3.
無心義的佔行文字4.

6.1. 引用的多層嵌套

區塊引用能夠嵌套(例如:引用內的引用),只要根據層次加上不一樣數量的 > :

>>> 請問 Markdwon 怎麼用? - 小白

>> 本身看教程! - 憤青

> 教程在哪? - 小白

請問 Markdwon 怎麼用? - 小白

本身看教程! - 憤青

教程在哪? - 小白

6.2. 引用其它要素

引用的區塊內也可使用其餘的 Markdown 語法,包括標題、列表、代碼區塊等:

> 1.   這是第一行列表項。
> 2.   這是第二行列表項。
> 
> 給出一些例子代碼:
> 
>     return shell_exec("echo $input | $markdown_script");
  1. 這是第一行列表項。
  2. 這是第二行列表項。

給出一些例子代碼:

return shell_exec("echo $input | $markdown_script");

7. 插入圖像

圖片的建立方式與超連接類似,並且和超連接同樣也有兩種寫法,行內式和參考式寫法。

語法中圖片Alt的意思是若是圖片由於某些緣由不能顯示,就用定義的圖片Alt文字來代替圖片。 圖片Title則和連接中的Title同樣,表示鼠標懸停與圖片上時出現的文字。 Alt 和 Title 都不是必須的,能夠省略,但建議寫上。

##### 7.1. 行內式

語法說明:圖片Alt

美麗風景: 
![美麗風景](https://yuhongjun.github.io/assets/media/scenery.jpeg "美麗風景")

view
美麗風景:
美麗風景

7.2. 參考式

語法說明:

在文檔要插入圖片的地方寫[圖片Alt][標記]

在文檔的最後寫上[標記]:圖片地址 「Title」

![美麗風景](https://yuhongjun.github.io/assets/media/scenery.jpeg "美麗風景")

[scenery]:https://yuhongjun.github.io/assets/media/scenery.jpeg "美麗風景"

view
美麗風景


8. 內容目錄

在段落中填寫 [TOC] 以顯示全文內容的目錄結構。

效果參見最上方的目錄


9. 註腳

語法說明:

在須要添加註腳的文字後加上腳註名字[^註腳名字],稱爲加註。 而後在文本的任意位置(通常在最後)添加腳註,腳註前必須有對應的腳註名字。

注意:經測試註腳與註腳之間必須空一行,否則會失效。成功後會發現,即便你沒有把註腳寫在文末,經Markdown轉換後,也會自動歸類到文章的最後。

使用 Markdown[^1]能夠效率的書寫文檔, 直接轉換成 HTML[^2], 你可使用 Leanote[^Le] 編輯器進行書寫。

[^1]:Markdown是一種純文本標記語言

[^2]:HyperText Markup Language 超文本標記語言

[^Le]:開源筆記平臺,支持Markdown和筆記直接發爲博文

view

使用 Markdown1能夠效率的書寫文檔, 直接轉換成 HTML2, 你可使用 Leanote3 編輯器進行書寫。

注:腳註自動被搬運到最後面,請到文章末尾查看,而且腳註後方的連接能夠直接跳轉回到加註的地方。


10. LaTeX 公式

10.1. $ 表示行內公式:
質能守恆方程能夠用一個很簡潔的方程式 $E=mc^2$ 來表達。

view
質能守恆方程能夠用一個很簡潔的方程式 $E=mc^2$ 來表達。

10.2 $$ 表示整行公式:
$$\sum_{i=1}^n a_i=0$$
$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$
$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$

訪問 MathJax 參考更多使用方法。


11. 流程圖

<div>
<textarea id="code" style="width: 100%;" rows="11">
st=>start: Start|past:>http://www.google.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes
or No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request

st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e
</textarea>
</div>
<div>
<button id="run" type="button">Run</button>
</div>
<div id="canvas"></div>

you can try different in textarea,then run .

更多語法參考:流程圖語法參考


12 .表格

語法說明:

不論是哪一種方式,第一行爲表頭,第二行分隔表頭和主體部分,第三行開始每一行爲一個表格行。
列於列之間用管道符|隔開。原生方式的表格每一行的兩邊也要有管道符。
第二行還能夠爲不一樣的列指定對齊方向。默認爲左對齊,在-右邊加上:就右對齊。

  1. 簡單方式寫表格:
學號|姓名|分數
-|-|-
小明|男|75
小紅|女|79
小陸|男|92

2.原生方式寫表格:

|學號|姓名|分數|
|-|-|-|
|小明|男|75|
|小紅|女|79|
|小陸|男|92|

3.爲表格第二列指定方向:

產品|價格
-|-:
Leanote 高級帳號|60元/年
Leanote 超級帳號|120元/年

view

  1. 簡單方式寫表格:
學號 姓名 分數
小明 75
小紅 79
小陸 92

2.原生方式寫表格:

學號 姓名 分數
小明 75
小紅 79
小陸 92

3.爲表格第二列指定方向:

產品 價格
Leanote 高級帳號 60元/年
Leanote 超級帳號 120元/年

13. 分隔線

你能夠在一行中用三個以上的星號、減號、底線來創建一個分隔線,行內不能有其餘東西。你也能夠在星號或是減號中間插入空格。下面每種寫法均可以創建分隔線:

* * *

***

*****

- - -

---------------------------------------

顯示效果都同樣


14. 代碼

對於程序員來講這個功能是必不可少的,插入程序代碼的方式有兩種,一種是利用縮進(Tab), 另外一種是利用」`」符號(通常在ESC鍵下方)包裹代碼。

語法說明:

  1. 插入行內代碼,即插入一個單詞或者一句代碼的狀況,使用code這樣的形式插入。
  2. 插入多行代碼,可使用縮進或者「code 「,具體看示例。

注意: 縮進式插入前方必須有空行

14.1. 行內式
C語言裏的函數 `scanf()` 怎麼使用?

view
C語言裏的函數 scanf() 怎麼使用?

14.2. 縮進式多行代碼

縮進 4 個空格或是 1 個製表符

一個代碼區塊會一直持續到沒有縮進的那一行(或是文件結尾)。

#include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

view

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
14.3. 用六個包裹多行代碼 ```markdown ` `

include <stdio.h>

int main(void)
{
printf("Hello world\n");
}
、、、
```

14.4. HTML 原始碼

在代碼區塊裏面, & 、 < 和 > 會自動轉成 HTML 實體,這樣的方式讓你很是容易使用 Markdown 插入範例用的 HTML 原始碼,只須要複製貼上,剩下的 Markdown 都會幫你處理,例如:

第一個例子:

<div class="footer">
   © 2016 ***
</div>

view


  1. Markdown是一種純文本標記語言

  2. HyperText Markup Language 超文本標記語言

  3. 開源筆記平臺,支持Markdown和筆記直接發爲博文

相關文章
相關標籤/搜索