Markdown 編寫技巧彙總(一)

EYE發表於2021-09-29

編寫文件,有很多格式選擇,也有不同平臺選擇。下面就自己接觸到的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. 文字1
  2. 文字2
  3. 文字3
  4. 文字4
  5. 文字5

【PS】這裡我故意改寫成10.和1.,能夠發現markdown系統自動識別列表序號,無關使用者寫的具體數字。
當然還可以加入層級,如:

1. 文字1
2. 文字2
	1. 文字4
	2. 文字5
   2. 文字5
3. 文字3

得到:

  1. 文字1
  2. 文字2
    1. 文字4
    2. 文字5
    3. 文字6
  3. 文字3

【PS】有的系統會自動修改標註,加入不同層級的顯示。
需要定義下級的文字,在開頭新增一個縮排符tab或者3個以上的空格(太多空格不一定被識別)

 

結語

還有一些高階應用下篇繼續。值得說的是,不同的平臺,系統配置都有些許差距,得到的效果可能不太一樣,屬正常現象。

相關文章