.md即markdown檔案的基本常用撰寫語法,是一種快速標記、快速排版語言,現在很多前段專案中的說明檔案readme等都是用.md檔案撰寫的,而且很多企業也在在鼓勵使用這種編輯方式,特別作為一個前端從業者更要學會使用這種語言,下面就簡單和大家分享一些.md基本語法
題外話:我一般不安裝markdown編輯器,直接用idea就可以撰寫,
一、基本符號:* - +. >
基本上所有的markdown標記都是基于這四個符號或組合,需要注意的是,如果以基本符號開頭的標記,注意基本符號后有一個用于分割標記符和內容的空格,
二、標題
1.前面帶#號,后面帶文字,分別表示h1-h6,只到h6,而且h1下面會有一條橫線
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
2.相當于標簽閉合
# 一級標題 #
## 二級標題 ##
### 三級標題 ###
#### 四級標題 ####
##### 五級標題 #####
###### 六級標題 #####
三、串列
- 無序串列
//形式一
+ a
+ b
+ c
//形式二
- d
- e
- f
//形式三
* g
* h
* i
- 有序串列
//正常形式
1. abc
2. bcd
3. cde
//錯序效果
2. fgh
3. ghi
5. hij
如圖,注意,數字后面的點只能是英文的點,有序串列的序號是根據第一行串列的數字順序來的,
錯序串列的序號本來是序號是亂的, 但是還是顯示 2 3 5
- 嵌套串列
//無序串列嵌套
+ 123
+ abc
+ bcd
+ cde
+ 465
+ 789
//有序串列嵌套
1. abcd
1. abcde
2. abcde
3. abcde
2. bcde
3. cdef
串列可以嵌套,使用時在嵌套串列前按 tab 或 空格 來縮進,去控制串列的層數
四、參考說明區塊
對某個部分做的內容做一些說明或者參考某某的話等,可以用這個語法,
- 正常形式
> 參考內容、說明內容,在陳述句前面加一個 > ,注意是英文的那個右尖括號,注意空格,參考因為是一個區塊,理論上是應該什么內容都可以放,比如說:標題,串列,參考等等,
- 嵌套區塊
這里我只介紹一下我常用的方法,也是個人認為比較規范的一種方法,就是給區塊的下一級區塊多加一個右尖括號
> 一級參考
>> 二級參考
>>> 三級參考
>>>> 四級參考
>>>>> 五級參考
>>>>>> 六級參考
五、代碼塊
在發布一些技術文章會涉及展示代碼的問題,這時候代碼塊就顯得尤為重要,
- 少量代碼,單行使用,直接用`包裹起來就行了
` shaoliangdaima,danhangshiyong `
- 大量代碼,需要多行使用,用```包裹起來
```
daliangdaima,xuyaoduohangshiyong
daliangdaima,xuyaoduohangshiyong
daliangdaima,xuyaoduohangshiyong
daliangdaima,xuyaoduohangshiyong
daliangdaima,xuyaoduohangshiyong
```
六、鏈接
- 行內式
鏈接的文字放在[]中,鏈接地址放在隨后的()中,鏈接也可以帶title屬性,鏈接地址后面空一格,然后用引號引起來
[簡書](https://www.jianshu.com "創作你的創作"),
是一個創作社區,任何人均可以在其上進行創作,用戶在簡書上面可以方便的創作自己的作品,互相交流,
- 引數式
鏈接的文字放在[]中,鏈接地址放在隨后的:后,鏈接地址后面空一格,然后用引號引起來
[簡書]: https://www.jianshu.com "創作你的創作"
[簡書]是一個創作社區,任何人均可以在其上進行創作,用戶在簡書上面可以方便的創作自己的作品,互相交流,
//引數定義的其他寫法
[簡書]: https://www.jianshu.com '創作你的創作'
[簡書]: https://www.jianshu.com (創作你的創作)
[簡書]: <https://www.jianshu.com> "創作你的創作"
七、圖片
- 行內式
和鏈接的形式差不多,圖片的名字放在[]中,圖片地址放在隨后的()中,title屬性(圖片地址后面空一格,然后用引號引起來),注意的是[]前要加上!

- 引數式
圖片的文字放在[]中,圖片地址放在隨后的:后,title屬性(圖片地址后面空一格,然后用引號引起來),注意參考圖片的時候在[]前要加上!
[my-logo.png]: https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "my-logo"
![my-logo.png]
//引數定義的其他寫法
[my-logo.png]: https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 'my-logo'
[my-logo.png]: https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 (my-logo)
[my-logo.png]: <https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240> "my-logo"
八、分割線
分割線可以由* - _(星號,減號,底線)這3個符號的至少3個符號表示,注意至少要3個,且不需要連續,有空格也可以
---
- - -
------
***
* * *
******
___
_ _ _
______
九、其他
- 強調字體
一個星號或者是一個下劃線包起來,會轉換為<em>傾斜,如果是2個,會轉換為<strong>加粗
*md*
**md**
_md_
__md__
- 轉義
基本上和js轉義一樣,\加需要轉義的字符
\\
\*
\+
\-
\`
\_
- 洗掉線
用~~把需要顯示洗掉線的字符包裹起來
~~洗掉~~
十、表格
//例子一
|123|234|345|
|:-|:-:|-:|
|abc|bcd|cde|
|abc|bcd|cde|
|abc|bcd|cde|
//例子二
|123|234|345|
|:---|:---:|---:|
|abc|bcd|cde|
|abc|bcd|cde|
|abc|bcd|cde|
//例子三
123|234|345
:-|:-:|-:
abc|bcd|cde
abc|bcd|cde
abc|bcd|cde
上面三個例子的效果一樣,由此可得:
1. 表格的格式不一定要對的非常起,但是為了良好的變成風格,盡量對齊是最好的
2. 分割線后面的冒號表示對齊方式,寫在左邊表示左對齊,右邊為右對齊,兩邊都寫表示居中

轉載請註明出處,本文鏈接:https://www.uj5u.com/houduan/521778.html
標籤:Java
