Markdown 的基本使用

一. 為什么選擇 Markdown?

Markdown 是一種輕量級(jí)的富文本標(biāo)記語(yǔ)言,用戶可以通過(guò)純文本的形式,使用其特有的語(yǔ)法標(biāo)準(zhǔn),可以達(dá)到很好的效果展示。
同時(shí),使用 MarkDown 編寫(xiě)的文檔可以很輕易的轉(zhuǎn)化為包括 html 文本在內(nèi)的其他諸多形式的文件。這為我們的以后的處理文檔提供了很大的便利性。
其次,網(wǎng)上各種的在線編輯工具或者是本地的文本編輯工具都支持都支持 Markdown 語(yǔ)法書(shū)寫(xiě),這使得我們編寫(xiě) Markdown 文檔比較方便。

下面,來(lái)看看百度的說(shuō)法:

Markdown的語(yǔ)法簡(jiǎn)潔明了、學(xué)習(xí)容易,而且功能比純文本更強(qiáng),因此有很多人用它寫(xiě)博客。世界上最流行的博客平臺(tái)WordPress和大型CMS如Joomla、Drupal都能很好的支持Markdown。完全采用Markdown編輯器的博客平臺(tái)有Ghost和Typecho。
在數(shù)據(jù)科學(xué)領(lǐng)域,Markdown已經(jīng)被確立為科學(xué)研究規(guī)范,極大地推進(jìn)了動(dòng)態(tài)可重復(fù)性研究的歷史進(jìn)程。

所以說(shuō),使用 Markdown 語(yǔ)法編寫(xiě)文檔是一個(gè)不錯(cuò)的選擇。雖然我平時(shí)雖然書(shū)寫(xiě)文章比較少,但是,Markdown 的簡(jiǎn)便性,實(shí)用性,已經(jīng)深深的吸引了我。

二. Markdown 的基本語(yǔ)法。

首先貼一下中文語(yǔ)法鏈接 Markdown中文語(yǔ)法鏈接

MarkDown 的基本語(yǔ)法就是標(biāo)記符號(hào)的使用。原理應(yīng)該和瀏覽器解析 html 文的原理差不多。就是,Markdown 語(yǔ)句會(huì)默認(rèn)的規(guī)定一些關(guān)鍵字,當(dāng)解析器遇到這些關(guān)鍵字之后,就將關(guān)鍵字之后的特定長(zhǎng)度的內(nèi)容解析為相應(yīng)的格式,并通過(guò)某種格式展現(xiàn)出來(lái)。

  1. 標(biāo)題
    Markdown 的標(biāo)題共分為 6 個(gè)等級(jí),使用 "#" 進(jìn)行標(biāo)識(shí),"#" 的數(shù)量表示它后面的內(nèi)容為第幾級(jí)標(biāo)題,建議在 # 后面加一個(gè)空格。
    這篇文章的每個(gè)部分的開(kāi)頭就是一級(jí)標(biāo)題。使用的語(yǔ)句為:
# 一. 為什么選擇 Markdown ?
  1. 文本樣式
  • 斜體:使用一個(gè) * 或者 _ 將所需要的內(nèi)容包裹
  • 加粗:使用兩個(gè) * 或者 _ 將所需要的內(nèi)容包裹
  • 刪除線:使用兩個(gè) ~ 將內(nèi)容包裹
  • 高亮:使用兩個(gè) = 將內(nèi)容包裹
*斜體* _斜體2_
** 粗體** __粗體__
~~刪除線~~
==高亮==

斜體 斜體2
粗體 粗體2
刪除線
==高亮==

段落: 段落之間空一行
換行符: 一行結(jié)束時(shí)輸入兩個(gè)空格

列表:* 或者 - 或 + 成為一個(gè)新的列表項(xiàng),這個(gè)為無(wú)序列表?;煊脮?huì)出現(xiàn)比較大的空白間距。
需要添加有序列表則需要使用 數(shù)字+.+空格的形式。經(jīng)測(cè)試,與使用的序號(hào)關(guān)系不大,他是按照一個(gè)接一個(gè)的順序加上去的序號(hào)。

無(wú)序列表
* item1
* item2
- item3
- item4

有序列表
1. item1
2. item2

無(wú)序列表

  • item1
  • item2
  • item3
  • item4
  • item5
  • item6

有序列表

  1. item1
  2. item2

引用: > 引用內(nèi)容 ,上面的的效果就是引用來(lái)實(shí)現(xiàn)的
內(nèi)嵌代碼 : 單行使用 ` 將代碼包裹
多行使用 ``` 將代碼包裹
還可以使用每一行前面加4個(gè)空格標(biāo)記一個(gè)代碼段

Markdow插入代碼
Markdow插入代碼

#include<stdio.h>

int main(){
    printf("hello!");
    return 0;
}
boolean getMax(int a, int b){
    return a >= b? a : b;
}  

畫(huà)水平線:在一行中用三個(gè)以上的星號(hào)(*)、減號(hào)(-)、下劃線(_)來(lái)建立一個(gè)分隔線;除空格外行內(nèi)不能有其他字符;(除第一個(gè)符號(hào)的左側(cè)最多添加三個(gè)空格外)三個(gè)相同符號(hào)兩側(cè)可以添加任意多個(gè)空格。

___
---
***  



  1. 鏈接
    鏈接分為兩類:一類是普通的網(wǎng)絡(luò)鏈接,另外一類是圖片鏈接
普通鏈接為:[百度](https://www.baidu.com)
圖片鏈接為:![Markdow插入代碼](http://ww1.sinaimg.cn/large/005Py2KCly1fjiy20irzjj309t06974n.jpg)

效果如下:
普通鏈接為:百度
圖片鏈接為:

  1. 表格
    Markdown 的表格算是比較難寫(xiě)的。
    第一行為各個(gè)列的表名稱。第二行為下面內(nèi)容的對(duì)齊方式,使用:進(jìn)行標(biāo)記。兩個(gè)冒號(hào)加上減號(hào) (-) 表示居中,減號(hào)后面是:表示居右,默認(rèn)居左。
| cloth         | price         |color  |
| ------------- |:-------------:| -----:|
| 褲子          | 15R | 紅 |
| 襪子          | 2R      |   黑 |

cloth price color
褲子 15R
襪子 2R

三. MarkDown 注意事項(xiàng)。

  1. 因?yàn)?Markdown 中的空格起著樣式控制的作用,所以很多時(shí)候很難直接輸入空格。因此我們可以使用 html語(yǔ)法中的方法
  //半角空格(英文)
?//全角空格(中文)

我前面有空格。
? 我前面也有。

  1. Markdown 和 html 是兼容的。甚至可以直接在其中使用html語(yǔ)法的標(biāo)簽。
    (但是顯然有道云筆記是不支持這種操作的,簡(jiǎn)書(shū)貌似也不支持。)

<table>
<tr>
<td>Foo</td>
</tr>
</table>

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

相關(guān)閱讀更多精彩內(nèi)容

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