Markdown語法

markdown圖標

Markdown是什么?

一種輕量級標記語言,主要用于文檔寫作
標記語言還有HTML,XML等

Markdown的優(yōu)點

Markdown的語法簡潔明了、容易上手,而且功能比純文本更
強。很多博客平臺均支持Markdown,github的README.MD等類似 
的說明文檔也均采用Markdown編寫

Markdown的使用指南

1.標題

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

效果如下:

標題效果圖

效果說明

標題一共分為六級,"#"號的個數(shù)代表級數(shù),標題文字與"#"至少一個空格(space或是tab都可以)
具體格式為:# 空格 標題文字

2.文本樣式

2.1鏈接
這是一個[簡書鏈接](http://m.itdecent.cn/)
這是一個簡書鏈接(http://m.itdecent.cn/)
這是一個[簡書鏈接](http://m.itdecent.cn/ "title我是簡書哦")
https://www.jpjbp.com/
(https://www.jpjbp.com/)
<http://m.itdecent.cn/>

效果如下:
這是一個簡書鏈接
這是一個簡書鏈接(http://m.itdecent.cn/)
這是一個簡書鏈接
http://m.itdecent.cn/
(https://www.jpjbp.com/)
http://m.itdecent.cn/

附上有title顯示的效果圖

效果說明

鏈接格式:
URL                         自生成鏈接
<URL>                       自生成鏈接
(URL)                       前面沒有中括號會生成一個帶括號的鏈接
[文字](URL)                 不帶標題,符號"]"和"("之間不能有其他字符,空格都不行
[文字](URL空格"標題內(nèi)容")    帶標題,記得URL和標題內(nèi)容之間加空格
2.2強調(diào)
~~刪除~~
**加粗**
__加粗__
*斜體*
_斜體_
*__斜體加粗__*
__*斜體加粗*__
_**斜體加粗**_
**_斜體加粗_**

效果如下:

刪除
加粗
加粗
斜體
斜體
斜體加粗
斜體加粗
斜體加粗
斜體加粗
斜體加粗
斜體加粗

強調(diào)效果展示

效果說明

下劃線"_"和星號"*"效果基本相同
特別說明:帶"*"星號的文本樣式,在原版Markdown標準中不存在,但在其大部分衍生標準中被添加
2.3段落
一個'Markdown段落'是由一個或多個連續(xù)的文本行組成,它的前后要有一個以上
的空行。普通段落不該用空格或制表符來縮進。段落的前后要有'空行'。(所謂的空
行是指沒有文字內(nèi)容,通過Enter鍵即可。若想在段內(nèi)強制換行的方式是使用兩個
以上空格加上回車)

效果展示:

我是一個段落,就像word中的正文


段落
2.4區(qū)塊引用
在需引用的行使用符號 ">" ,也可使用多個嵌套引用,如:
>一切都是命運石門的選擇  

>一級引用嵌套
>>二級引用嵌套
>>>>四級引用嵌套

一切都是命運石門的選擇

一級引用嵌套

二級引用嵌套

四級引用嵌套

2.5代碼區(qū)塊
代碼區(qū)塊的建立是在每行加上4個空格或者二個制表符(如同寫代碼一樣)。
不同的編寫工具在空格和制表符的數(shù)量上會有差異,簡書Markdown是符合的
可以用下面的寫法代碼塊的開頭和結(jié)尾均用三個"`"符號。(注意:"`"不是單引號,
是Tab鍵上面的那個,稱為反引號(backquote))  

行內(nèi)短代碼`System.out.println("我是瓜瓜")`

```
public static void main(String[] args){
  Scanner scanner = new Scanner(System.in);//創(chuàng)建一個Scanner的實例
  String s = scanner.nextLine();  
  System.out.println("您輸入的是:"+s)
}
```

```
  <school>
    <teacher>瓜瓜</teacher>
    <student>冒冒</student>
  </school>
```

```
<html>
  <head>
    <title>這是標題</title>
  </head>
  <body>我是身體</body>
</html>
```

效果如下:

行內(nèi)短代碼System.out.println("我是瓜瓜")

public static void main(String[] args){
  Scanner scanner = new Scanner(System.in);//創(chuàng)建一個Scanner的實例
  String s = scanner.nextLine();  
  System.out.println("您輸入的是:"+s)
}
 <!--我是一個注釋-->
  <school>
    <teacher>我</teacher>
    <student>你</student>
  </school>
<html>
  <head>
    <title>這是標題</title>
  </head>
  <body>我是身體</body>
</html>
2.6列表 (無序,有序)
無序
通過"." 、"+"、"*"、或"-" 標記'無序列表',如:
-  第一個
-  第二個
+  第二個
*  第三個
*  第四個

效果如下:

  • 第一個
  • 第二個
  • 第二個
  • 第三個
  • 第四個
    無序列表.png

效果說明

無序列表中"." 、"+"、"*"、或"-" 標記都可以用,嵌套用的話會隔很大的空間
注意:標記和文字之間至少有一個空格,簡書似乎不支持"."符號,所以這里沒有
演示,我用其他的工具是可以的
有序
1. 第一個
1. 第一個
1. 第一個
1. 第一個  


1. 第一個
 第一個的內(nèi)容
1. 第二個
+ 無序表格
4. 第三個
2. 第四個
0. 第五個

效果如下:

  1. 第一個
  2. 第一個
  3. 第一個
  4. 第一個
  1. 第一個
    第一個的內(nèi)容
  2. 第二個
  • 無序表格
  1. 第三個
  2. 第四個
  3. 第五個

效果說明

有序列表通過數(shù)字加"."進行自動的標號,生成后的序號從1開始,可以插入無序列表
注意:"."后面至少一個空格
2.7分割線
***
---
_____ 

效果如下:




3.圖片

添加圖片形式和鏈接類似,只需要在鏈接的格式上最前方加一個"!"即可
![Markdown](https://upload-images.jianshu.io/upload_images/7473008-4962c96ed733892d.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果如下:

Markdown

效果說明

     ![Message](URL)                  不帶title的
     ![Message](URL "title")          帶title的,URL與"title"之間至少一個空格

4.反斜杠"\"

如果您使用"*"不是為了讓它具有一個特殊功能,比如標記無序列表或是斜體粗體
等,而是想讓它直接輸出為一個星號字符就可以這樣: 
\*\*it\*\*
**it**
\+ 1
* 1
\* 1

效果如下:
**it**
it
+ 1

  • 1
    * 1

效果說明

想讓特殊功能字符原樣輸出就可以用反斜杠"\"轉(zhuǎn)義("\"也稱為轉(zhuǎn)義符)

5.表格

姓名|性別
-|-
瓜瓜|男
冒冒|女

姓名|城市
-:|-:
瓜瓜|江西
冒冒|江西

效果如下:

姓名 性別
瓜瓜
冒冒
姓名 城市
瓜瓜 江西
冒冒 江西

效果說明

表格單元內(nèi)容默認是左對齊的,可以通過"-|-"加冒號改變,比如:
"-:|-:"        兩列都是右對齊
"-|-:"         第一個列左對齊,第二個列是右對齊
"-|:-:"        第一個列左對齊,第二個列是居中

詳細語法請參考
Markdown 語法說明

感謝您的閱讀,如有寫的不妥之處,還望您批評指正,謝謝

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

友情鏈接更多精彩內(nèi)容