Markdown 編寫技巧匯總(一)


編寫文檔,有很多格式選擇,也有不同平台選擇。下面就自己接觸到的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個以上的空格(太多空格不一定被識別)

 

結語

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


免責聲明!

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



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