1. 程式人生 > 其它 >Markdown學習文件

Markdown學習文件

技術標籤:markdownmarkdown

文章目錄

MarkDown

前言

什麼是MarkDown

Markdown是一種輕量級標記語言,它以純文字形式(易讀、易寫、易更改)編寫文件。

​ 通常使用的.doc或.txt。.doc文件過於臃腫,且使用者需要過多的在乎格式的書寫,而不是文件內容;.txt文件過於簡陋,只能進行簡單的文字編寫,無法進行圖片插入的操作。

​ 因此,Aaron SwartzJohn Gruber共同設計了Markdown標記語言,文件的字尾為.md。這類檔案,簡言之,即建立在txt的基礎上、通過簡單的符號語法使其能夠滿足格式的顯示、同時也能夠進行圖片插入、列表、流程圖製作等操作的輕量級文字書寫工具。

Markdown的優勢

  • 易讀易寫易修改,輕量級,極簡主義的思想
  • 相容HTML,能夠轉換為HTML格式釋出
  • 跨平臺

語法

1.多級標題

兩種形式:

  • 使用 = 和 - 標記一級二級標題

    一級標題
    =========
    二級標題
    ---------
    

    效果:

    ​ 一級標題

    二級標題

  • 使用 # 能顯示 1-6 級標題(注意符號和文字之間有空格)

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

    效果:

    一級標題

    二級標題

    三級標題

    四級標題

    五級標題
    六級標題

2. 段落

​ 段落的前後要有空行,所謂的空行是指沒有文字內容。若想在段內強制換行的方式是使用兩個以上空格加上回車(引用中換行省略回車)。

3.區塊

​ 在段落的每行或者只在第一行使用符號>,還可使用多個巢狀引用,如:(注意符號和數字之間有空格)

> 區塊引用
>> 巢狀引用
>> **可使用別的標記語法**

​ 效果:

區塊應用

巢狀應用

可使用別的標記語法

4.程式碼區塊

​ 使用 ```[程式碼格式]可形成一個程式碼區塊,能夠更加清晰的展現程式碼(關鍵字顏色)

​```c
#include <stdio.h>
int main(int argc, const char *argv[])
{
	return 0;
}

​ 效果:

#include <stdio.h>
int main(int argc, const char *argv[])
{
	return 0;
}

5.強調字型

​ 在強調內容兩側分別加上*或者_,如:

*斜體*,_斜體_
**粗體**,__粗體__

​ 效果:

斜體斜體
粗體粗體

6.列表

無序列表

​ 使用·+、或-標記無序列表,如:(注意符號和文字之間有空格)

- (+*) 第一項
- (+*) 第二項
- (+*) 第三項

​ 效果:

  • 第一項
  • 第二項
  • 第三項

有序列表

​ 有序列表的標記方式是將上述的符號換成數字,並輔以.,如:(注意符號和文字之間有空格)

1 . 第一項
2 . 第二項
3 . 第三項

​ 效果:

  1. 第一項
  2. 第二項
  3. 第三項

7.分割線

​ 分割線最常使用就是三個或以上*,還可以使用-_

---(回車)

​ 效果:


8.連結

行內式連結

​ 格式:

[**](link "description")

​ 效果:

baidu

參考式連結

​ 格式:

[**][a]

words...
...

[a]:link "description"

​ 效果:

baidu

word…

9.圖片插入

​ 新增圖片的形式和連結相似,只需在連結的基礎上前方加一個

![圖片名稱](link)

​ 效果:

在這裡插入圖片描述

10.反斜槓

​ 因為識別符號是Markdown語法的主體,所以要想表示識別符號,要在識別符號前加上\

\\ \- \` \'

​ 效果:

​ \ - ` ’

11.行內程式碼

​ 使用 ``將行內的程式碼包住,從而起到標記作用

我定義了一個變數` int a  `

​ 效果:

​ 我定義了一個變數 int a

12.表格

​ 繪製一張表格,–:右對齊,:-- 左對齊:, — 為表頭和表項的分隔符

| name | id | salary |
|------|---:|:-------|
|xiaoming| 1 | 10000 |
|xiaohong| 2 | 20000 |

​ 效果:

nameidsalary
xiaoming110000
xiaohong220000

13.刪除線

​ 用~~ ~~包住的文字

~~1 error(s), 1 warning(s)~~

​ 效果:

1 error(s), 1 warning(s)

14.UML圖

序列圖

​```mermaid
sequenceDiagram
up->>reader: 一鍵三連了嘛
Note right of reader: thinking...
reader->>up: 下次一定
​```

​ 效果:

up reader 一鍵三連了嘛 thinking... 下次一定 up reader

流程圖

​```mermaid
flowchat
st=>start: begin
end=>end: end
NO=>operation: 下次一定
YES=>operation: 白嫖失敗
cond=>condition: 一鍵三連

st->cond
cond(yes)->YES
cond(no)->NO
YES->end
NO->end

​```

​ 效果:

Created with Raphaël 2.2.0 begin 一鍵三連 白嫖失敗 end 下次一定 yes no