『markdown』入門語法介紹

如果想在網上發發文章,寫寫博客,那么markdown是非常推薦的一門語言,文字工作者,IT從業者等等都可以花一點時間來學一學,語法簡單,使用靈活。

什么是markdown

拋開那些嚴謹的官方定義,我個人理解markdown就是一種簡易的語言,可以舒服的書寫及排版文本文字。
??可以用一些規定符號對文字方便的進行格式化和排版,讀寫都很方便。
??markdown是兼容HTML的,這就能實現很多炫酷的樣式啦,搞過前端的朋友肯定很熟悉。

markdown語法介紹

1. 標題

markdown中如何表示標題呢,比如此篇開頭的標題:

什么是markdown

實現標題效果,只需要:

#標題名

可以輸出1-6個#來對應1-6級標題(其中1級標題字體最大,6級標題字體最小)。


2.引用

學會了標題,有人可能奇怪文章頭部以及標題語法中的那種引用區是如何實現的。想要實現引用區,只需要在文字前加入>號:

>曾夢想仗劍走天涯
>看一看世界的繁華

當然你不用每行都加上>,只需要第一行首寫一個就能作用整個段落,如下:

>曾夢想仗劍走天涯
看一看世界的繁華

效果相同。


3.列表

  • 無序列表:
  • Java
  • JavaScript
  • Python

想要實現無序列表,需要*+空格+表項,注意*和表項中間是有個空格的:

* Java
* JavaScript
* Python

  • 有序列表:
  1. Java
  1. JavaScript
  2. Python

實現有序列表,只需要將無序列表中*位置替換成數字+句點,即數字+句點+空格+表項。


4.代碼區

如果你的文章需要插入代碼,那么就要用到代碼區塊了,效果是這樣的:

String helloMarkDown = "hello markdown";

public void deJunz(String words){
    System.out.println(words);
}

deJunz(helloMarkDown);//hello markdown

想要插入代碼,只需要在你插入的每行代碼前輸入四個空格或一個制表符即可,記得要在每行前都縮進,不然會打亂排版。

嫌麻煩?還有一種寫法,通過反引號`來標識代碼首尾:

首尾使用一個反引號:
String helloMarkDown = "hello markdown"; public void deJunz(String words){ System.out.println(words); } eJunz(helloMarkDown);//不縮進,一個反引號包含首尾(2個效果相同)

首尾使用三個反引號:

String helloMarkDown = "hello markdown";
public void deJunz(String words){
    System.out.println(words);
   }
eJunz(helloMarkDown);//不縮進,三個反引號包含首尾

可見使用三個反引號時效果與首行縮進相同。


5.字體的斜體和加粗

寫文章難免需要特殊標記一些文字,比如在上面就能看到一些我加粗的重點文字。

  • 字體傾斜:

我斜啦

斜體可以使用一對*或者_來包裹目標文字:

*我斜啦*
_我斜啦_

  • 字體加粗

我粗啦

粗體可以使用一對**或者__來包裹目標文字,相比斜體多了一個特殊符號:

**我粗啦**
__我粗啦__

用*或_號的效果相同的,隨便選擇。


6.圖片和鏈接

  • 插入圖片:

一般的markdown編輯器的工具欄都有圖像化插入操作界面,這里重點介紹下通過語法進行對圖片鏈接進行引用。

語法如下:

![圖片介紹](url)

即,嘆號+左方括號+描述文字+右方括號+左小括號+鏈接+右小括號。

通過url顯示我的頭像,寫法如下:

![我的頭像](myURL) //myURL就是我頭像所在網址,太長在這里簡寫

效果如圖:


我的頭像

還有一種引用方法,是先定義圖片的id,再進行引用,這兩種方法最終都會生成相同的markdown語句,本質是相同的,有興趣的朋友自己去學習下另一種方法吧,這里不介紹了。

  • 鏈接:

會了引用圖片,鏈接就簡單多啦,語法如下:

[顯示文本](url "鼠標指向提示信息")

可以看出,相比圖片,少了一個!,但是小括號里多了一個屬性,與url通過空格隔開,這個屬性的作用是在你鼠標停在鏈接上時會彈出提示信息,注意,這個屬性是可選的,寫成如下形式也可以:

[顯示文本](url)

這里會鏈接到我的文章列表:deJunz文章列表

寫法:

[deJunz文章列表](URL "dejunz")


Tips

下面是我在使用markdown的一些經驗:

1. 轉義

有時候我們想單純打出*[\等功能字符,這是時就需要用到了轉義字符\,通過\*就能以文本形式顯示出特殊功能字符。

2. 空格

markdown中如何打空格

表示一個空格

3. 列表和標題一起使用
  • 如果標題欄正好是一系無序列表,那么先輸入*再輸入#,不然無法正確識別。
  • 刺客信條

寫法為:

* ###### 刺客信條

  • 若標題為有序列表
    則應先輸入#再輸入數字和句點。
    若先輸入數字和句點再輸入#號,可能會這樣:
  1. 無主之地

發現數字沒有和文本統一格式大小,顯然這影響閱讀。

正確寫法:

#### 1. 無主之地

效果:

1. 無主之地

4. 分隔線

使用連續的* _ -三種字符繪制分隔線,效果相同,如下:


5. 段內代碼塊

如果想達到這種段內代碼塊效果:

飛雪連天射白鹿

只需要用單個反引號將目標文字首尾包含。

寫法:

飛雪`連天`射白鹿

6. 兼容HTML

markdown兼容HTML(一些操作直接是生成HTML顯示的)。

比如換行操作直接輸入:

<br />

就可完成換行操作。

<br /><br />


文章內容為個人理解,如有錯誤歡迎指出。

郵箱:CodingDjz@126.com

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,106評論 6 542
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,441評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,211評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,736評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,475評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,834評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,829評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,009評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,559評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,306評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,516評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,038評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,728評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,132評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,443評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,249評論 3 399
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,484評論 2 379

推薦閱讀更多精彩內容