編寫文檔,有很多格式選擇,也有不同平台選擇。下面就自己接觸到的MarkDown編寫文檔的各種技巧做簡單梳理,供自己參閱,也希望幫到網友。
【1】添加空格
①
這種寫法比較老土,但是,很實用!注意都是英文狀態下的字符,想要多個空格就多復制幾次,怎么樣的排版都能排上!
②
鍵入全角輸入狀態下"空格",直接敲擊鍵入即可!
這種方法很快捷,但也有弊端,不容易在編輯欄中查詢修改,建議用一種方式輸入空格,盡量避免多種方式混用!
【2】文字標重
指的是將文字內容加粗、加背景顏色等視覺效果,以此讓文本整體渲染得更好看,也提醒讀者一些重要信息。
加粗 可用** **
來標記,如:
**這是一行被加粗的句子**
斜字 可用* *
來標記,如:
*這是一行傾斜的句子*
粗斜體 可用*** ***
來標記,如:
***這是一行粗斜體文字***
加底色 可用== ==
來標記,如:
==這里需要被添加底色==
【3】代碼(塊)
單行代碼(有時也可作為重標文字來使用):
你好
a=1
*p=*p1+*p2
編寫方法[ 用`來包裹文字內容]:
`你好` `a=1` `*p=*p1+*p2`
多行代碼 [代碼塊]:
int a = 1;
int b = -100;
void main()
{
int c = a + b;
println(c);
}
使用```
來包裹文本,如:
```
int a = 1;
int b = -100;
void main()
{
int c = a + b;
println(c);
}
```
還能定義特定語種,如:
```c++
//這里是c++代碼
```
即在首個``` 后面加上語種。
【4】換行 空行
① 空行上鍵入
或 
,如:
我是一行普通的文本
我也是一行普通的文本
 
我還是一行普通的文本
得到結果:
我是一行普通的文本
我也是一行普通的文本
我還是一行普通的文本
② 鍵入:<br>
我是一行普通的文本
<br>
我也是一行普通的文本
<br>
我還是一行普通的文本
得到結果:
我是一行普通的文本
我也是一行普通的文本
我還是一行普通的文本
【5】引文
鍵入:>
,如:
> 哈哈,我是引文
得:
哈哈,我是引文
還能分級顯示,如:
> 我是一級文本
>> 我是二級文本
>>> 我是三級文本
>> 我是二級文本
> 我是一級文本
得到:
我是一級文本
我是二級文本
我是三級文本
我是二級文本
我是一級文本
還能在引文中嵌入代碼塊:
> 我是一行文本
>> ```
>> int a = 0;
>> ```
得:
我是一行文本
int a = 0;
【PS】注意`>`后面是可以跟上多行文本的,直到遇到回車換行。如下情況:
我是一行很長的文本。巴拉巴拉巴拉巴拉巴拉巴拉
發生的方式方式放松放松故事故事發發怪怪的發說法薩芬的
分身乏術分身乏術發順豐撒發順豐撒方式方法撒飛灑發
分身乏術發順豐撒發生的方式。
發送到方式放松放松發送方師傅。
寫法如下:
> 我是一行很長的文本。巴拉巴拉巴拉巴拉巴拉巴拉
發生的方式方式放松放松故事故事發發怪怪的發說法薩芬的
分身乏術分身乏術發順豐撒發順豐撒方式方法撒飛灑發
分身乏術發順豐撒發生的方式。
<br>
發送到方式放松放松發送方師傅。
【6】分割線
---
***
___
即在空行上鍵入三個及三個以上的\
、*
、_
即可!
【7】刪除線
被刪除的文本
~~被刪除的文本~~
在文本前后用~~
包裹。
【8】下划線
帶下划線的文本
<u>帶下划線的內容</u>
這是借用了Html5中的標記符號。
【9】列表
一、無序列表
鍵入*
、+
、-
都可[注意后面加個空格],如:
* 文本1
* 文本2
- 文本2
+ 文本3
得到:
- 文本1
- 文本2
- 文本2
- 文本3
二、有序列表
鍵入1.
、2.
、10.
等,如:
1. 文本1
2. 文本2
3. 文本3
10. 文本4
1. 文本5
得到:
- 文本1
- 文本2
- 文本3
- 文本4
- 文本5
【PS】這里我故意改寫成10.和1.,能夠發現markdown系統自動識別列表序號,無關用戶寫的具體數字。
當然還可以加入層級,如:
1. 文本1
2. 文本2
1. 文本4
2. 文本5
2. 文本5
3. 文本3
得到:
- 文本1
- 文本2
- 文本4
- 文本5
- 文本6
- 文本3
【PS】有的系統會自動修改標注,加入不同層級的顯示。
需要定義下級的文本,在開頭添加一個縮進符tab或者3個以上的空格(太多空格不一定被識別)
結語
還有一些高級應用下篇繼續。值得說的是,不同的平台,系統配置都有些許差距,得到的效果可能不太一樣,屬正常現象。