Markdown介紹和使用(超全建議收藏)


Markdown介紹

 Markdown 其實在 2004 年就有了,不過之前一直很小眾,這幾年隨着相關應用平台的發展,Markdown以其獨到的優勢迅速火起來了。Markdown編輯器使用一套格式標記語言來對文檔內容進行排版格式顯示。而Markdown的標記很少,常用的也就十個左右,它是一種非常輕量的標記語言

 Markdown編輯器深受技術人員的喜愛,Markdown可以用來編寫說明文檔,用它寫的文檔很多技術平台都能通用;Markdown可以用來寫技術博客,可以使說明部分和代碼都非常清晰易讀;Markdown格式轉換方便,還可以輕松地將文本轉換為 html、pdf等。

Markdown編輯器分類

 按照Markdown編輯器的使用環境,可以將它們歸納為三類。

平台集成工具:各大在線博客、社區平台自帶的寫作工具,比如CSDN、博客園、簡書等。
獨立軟件類:下載到自己機器上使用的獨立產品,可以編輯本地文件,比如Mou、MarkdownEditor、Haroopad等。
插件類:他自己本身是不能獨立使用的,可以在你現有的主流編輯器安裝,使你現有的編輯器具有Markdown的功能,比如Atom、WebStorm、Sublime Text等。

Markdown語法

一、標題寫法:

方法:(推薦這種方法;注意⚠️中間需要有一個空格)
關於標題還有等級表示法,分為六個等級,顯示的文本大小依次減小。不同等級之間是以井號 # 的個數來標識的。一級標題有一個 #,二級標題有兩個# ,以此類推。
例如:

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

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

目錄

* [背景介紹](#背景介紹)  
* [項目介紹](#項目介紹)  
* [使用說明](#使用說明)  
  * [獲取代碼](#獲取代碼)  
  * [開發插件](#開發插件)  
  * [使用ShurnimStorage接口](#使用ShurnimStorage接口)  
       * [接口介紹](#接口介紹)  
       * [使用樣例](#使用樣例)  
* [畫圖](#畫圖) 

背景介紹

水平線

***或者---

刪除線

~~在文字上添加刪除線~~ 

在文字上添加刪除線

二、編輯基本語法

1. 字體格式強調

我們可以使用下面的方式給我們的文本添加強調的效果

*強調*  (示例:斜體)  
 _強調_  (示例:斜體)  
**加重強調**  (示例:粗體)  
 __加重強調__ (示例:粗體)  
***特別強調*** (示例:粗斜體)  
___特別強調___  (示例:粗斜體) 

強調 (示例:斜體)
強調 (示例:斜體)
加重強調 (示例:粗體)
加重強調 (示例:粗體)
特別強調 (示例:粗斜體)
特別強調 (示例:粗斜體)

2、代碼

`<hello world>`  

<hello world>

3、代碼塊高亮

​```
@Override
protected void onDestroy() {
    EventBus.getDefault().unregister(this);
    super.onDestroy();
}
public static void main(String[]args){} //Java
​```
@Override
protected void onDestroy() {
    EventBus.getDefault().unregister(this);
    super.onDestroy();
}
public static void main(String[]args){} //Java

4、表格 (建議在表格前空一行,否則可能影響表格無法顯示)

表頭  | 表頭  | 表頭
 ---- | ----- | ------  
 單元格內容  | 單元格內容 | 單元格內容 
 單元格內容  | 單元格內容 | 單元格內容  
表頭 表頭 表頭
單元格內容 單元格內容 單元格內容
單元格內容 單元格內容 單元格內容

html方式表格

<table>
	<tr>
	    <th>條件</th>
	    <th colspan="2">有效等價類</th>
	    <th>編號</th>  
	    <th>無效等價類</th>  
	    <th>編號</th>  
	</tr >
	<tr>
        <td rowspan="9">輸入</td>
        <td colspan="2" rowspan="3">整數</td>
        <td rowspan="3">1</td>
        <td>小數</td>
        <td>12</td>
	</tr>
	<tr>
        <td>字符</td>
        <td>13</td>
	</tr>
	<tr>
        <td>空白</td>
        <td>14</td>
	</tr>
	<tr>
        <td rowspan="6">三個有效數</td>
        <td rowspan="2">﹣10000≤a≤10000</td>
        <td rowspan="2">2</td>
        <td>a<-10000</td>
        <td>15</td>
	</tr>
	<tr>
        <td>a>10000</td>
        <td>16</td>
	</tr>
	<tr>
        <td rowspan="2">﹣10000≤b≤10000</td>
        <td rowspan="2">3</td>
        <td>b<-10000</td>
        <td>17</td>
	</tr>
	<tr>
        <td>b>10000</td>
        <td>18</td>
	</tr>
	<tr>
        <td rowspan="2">﹣10000≤c≤10000</td>
        <td rowspan="2">4</td>
        <td>c<-10000</td>
        <td>19</td>
	</tr>
	<tr>
        <td>c>10000</td>
        <td>20</td>
	</tr>
	<tr>
        <td rowspan="7">輸出</td>
        <td rowspan="3">最大值是一個數</td>
        <td>a最大</td>
        <td>5</td>
	</tr>
	<tr>
        <td>b最大</td>
        <td>6</td>
	</tr>
	<tr>
        <td>c最大</td>
        <td>7</td>
	<tr>
        <td rowspan="3">最大值是兩個數</td>
        <td>a=b>c</td>
        <td>8</td>
	</tr>
	<tr>
        <td>b=c>a</td>
        <td>9</td>
	</tr>
	<tr>
        <td>c=a>b</td>
        <td>10</td>
	</tr>
	<tr>
        <td rowspan="3">最大值是三個數</td>
        <td>a=b=c</td>
        <td>11</td>
	</tr>
</table>
條件 有效等價類 編號 無效等價類 編號
輸入 整數 1 小數 12
字符 13
空白 14
三個有效數 ﹣10000≤a≤10000 2 a<-10000 15
a>10000 16
﹣10000≤b≤10000 3 b<-10000 17
b>10000 18
﹣10000≤c≤10000 4 c<-10000 19
c>10000 20
輸出 最大值是一個數 a最大 5
b最大 6
c最大 7
最大值是兩個數 a=b>c 8
b=c>a 9
c=a>b 10
最大值是三個數 a=b=c 11

可以使用</br>進行文本中換行,HTML和Markdown都適用

5、其他引用

圖片

![baidu](http://www.baidu.com/img/bdlogo.gif "百度logo")   
![圖片名稱](http://www.baidu.com/img/bdlogo.gif) 

baidu
圖片名稱

鏈接

[鏈接名稱](https://www.baidu.com/ "鼠標懸空展示文案")  
[鏈接名稱](https://www.baidu.com/) 

鏈接名稱
鏈接名稱

6、列表

無序列表

* 項目1  
* 項目2  
* 項目3 
   * 項目1 (一個*號會顯示為一個黑點,注意⚠️有空格,否則直接顯示為*項目1) 
   * 項目2   
  • 項目1
  • 項目2
  • 項目3
    • 項目1 (一個號會顯示為一個黑點,注意⚠️有空格,否則直接顯示為項目1)
    • 項目2

有序列表

1. 項目1  
2. 項目2  
3. 項目3  
   * 項目1  
   * 項目2 
   * 
  1. 項目1
  2. 項目2
  3. 項目3
    • 項目1
    • 項目2

7、換行(建議直接在前一行后面補兩個空格)

**直接回車不能換行, 可以在上一行文本后面補兩個空格, 這樣下一行的文本就換行了。
或者就是在兩行文本直接加一個空行。也能實現換行效果,不過這個行間距有點大。 **

8、引用

> 第一行引用文字  
> 第二行引用文字 

第一行引用文字
第二行引用文字

9. 層級結構展示

```
    * 編程語言
        * 腳本語言
            * python
```
  • 編程語言
    * 腳本語言
    * python

        > 數據結構
        >> 樹
        >>> 二叉樹
        >>>> 平衡二叉樹
        >>>>> 滿二叉樹 
    

    數據結構

    二叉樹

    平衡二叉樹

    滿二叉樹

10. 流程圖標

​```
graph LR
A-->B
b-->c
B-->c
​```

圖方向:

TB,從上到下
TD,從上到下
BT,從下到上
RL,從右到左
LR,從左到右

T = TOP,B = BOTTOM,L = LEFT,R = RIGHT,D = DOWN

graph TB
  A
  B[bname]
  C(cname)
  D((dname))
  E>ename]
  F{fname}

畫圖

有此方面需求的小伙伴可以參考此文章:https://blog.csdn.net/lis_12/article/details/80693975

連線

節點間的連接線有多種形狀,可以在連接線中加入標簽:

箭頭連接 A1–->B1  
開放連接 A2—B2  
標簽連接 A3–text—B3  
箭頭標簽連接 A4–text–>B4  
虛線開放連接 A5.-B5  
虛線箭頭連接 A6-.->B6  
標簽虛線連接 A7-.text.-B7  
標簽虛線箭頭連接 A8-.text.->B8  
粗線開放連接 A9===B9  
粗線箭頭連接 A10==>B10  
標簽粗線開放連接 A11==text===B11  
標簽粗線箭頭連接 A12==text==>B12  
graph TB
  A1-->B1
  A2---B2
  A3--text---B3
  A4--text-->B4
  A5-.-B5
  A6-.->B6
  A7-.text.-B7
  A8-.text.->B8
  A9===B9
  A10==>B10
  A11==text===B11
  A12==text==>B12


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM