Markdown語法學習(二)

2021-09-07 02:19:09 字數 2879 閱讀 7504

markdown 的目標是實現「易讀易寫」。

可讀性,無論如何,都是最重要的。乙份使用 markdown 格式撰寫的檔案應該可以直接以純文字發布,並且看起來不會像是由許多標籤或是格式指令所構成。markdown 語法受到一些既有 text-to-html 格式的影響,包括 setext、atx、textile、restructuredtext、grutatext 和 ettext,而最大靈感**其實是純文字電子郵件的格式。

總之, markdown 的語法全由一些符號所組成,這些符號經過精挑細選,其作用一目了然。比如:在文字兩旁加上星號,看起來就像強調。markdown 的列表看起來,嗯,就是列表。markdown 的區塊引用看起來就真的像是引用一段文字,就像你曾在電子郵件中見過的那樣。

markdown語法的目標是:成為一種適用於網路的書寫語言。

markdown 不是想要取代 html,甚至也沒有要和它相近,它的語法種類很少,只對應 html 標記的一小部分。markdown 的構想不是要使得 html 文件更容易書寫。在我看來, html 已經很容易寫了。markdown 的理念是,能讓文件更容易讀、寫和隨意改。html 是一種發布的格式,markdown 是一種書寫的格式。就這樣,markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。

不在 markdown 涵蓋範圍之內的標籤,都可以直接在文件裡面用 html 撰寫。不需要額外標註這是 html 或是 markdown;只要直接加標籤就可以了。

markdown中的段落需要使用乙個以上的空行,否則不會認為是單獨乙個段落。

markdown支援兩種格式標題形式:

類setext形式使用底線形式,=表示頂級標題,-表示第二級標題。

頂級標題

*****==

二級標題

-------

用markdown處理之後,效果如下:

類atx形式,在行首插入多個#,表示標題級數(支援六級),如下的語法形式:

#一級標題#

##二級標題

###**標題

####四級標題

最終轉化之後效果是這樣的:

四級標題使用字元">"(大於號),後面跟著乙個空格,表示乙個區塊引用。

比如下面這種語法

> 區塊引用測試
轉換之後的效果如下

區塊引用測試

區塊引用是可以自身巢狀的,可以使用其他的 markdown 語法,包括標題、列表、**區塊等。

比如下面的效果,可以用巢狀實現

這是區塊引用自身巢狀

下面是嵌入**

// c++ code

int value = 12345;

無序列表可以使用 星號*、加號+、減號-,作為標記。有序列表使用數字加乙個點號。下面的語法描述

* red

+ green

- blue

- 下面是有序列表

1. 小鳥

2. 大象

轉換之後的語法

下面是有序列表

小鳥大象

**區塊使用四個空格或乙個tab表示。通常這些區塊我們並不希望它以一般段落檔案的方式去排版,而是照原來的樣子顯示。比如下面的輸入(正常輸入前面加上四個空格縮排對齊):

sum = 0

for i=0, i < 100, ++i

sum += i

end for

可以在一行中使用三個以上的星號*、減號-、下劃線表示分割線。比如下面兩行:

***

---

實際顯示效果是這樣的:

***---

鏈結的文字使用[方括號]來標記。提示資訊可以用雙引號包含。

this is [an test](http://test "help")
轉換之後是這樣的:

this is an test

markdown使用星號*、和下劃線_,作為強調字元。

單個字元包圍的表示斜體,兩個字元包圍的表示黑體。

*italic* _italic_

**bold** __bold__

實際顯示效果

italic

italic

boldbold

markdown支援行內**。使用反引號`(左上角數字鍵1左邊對應的字元)。比如下面形式:

use `printf()` function
顯示為

useprintf()function

顯示效果

markdown支援轉移字元,使用反斜槓作為轉移符。比如可以使用轉移字元輸出markdown中使用的關鍵字元。

_ 底線

{} 花括號

方括號() 括弧

. 英文句點

! 驚嘆號

可以嘗試下:

這裡輸出中括號[4]。

本文是使用markdown編寫的語法學習總結。內容中用到比較多的是**區塊和區塊引用,主要是為了表示原始的語法格式和markdown轉換之後的效果對比。

不得不吐槽下,的markdown效果真的太差。完全沒法看出來優勢。

markdown語法學習

markdown是純文字格式的語法,支援轉換為html,可以幫助整理知識 學習筆記 markdown的段落是由若干行文字組成,前後由空行隔開 普通段落不該用空格或製表符縮排 markdown支援兩種標題樣式 setext和atx setext風格的標題用符號 first level 和 second...

markdown 語法學習

markdown是一種輕量級的標記語言,和html類似,但是易讀性比html要好很多。基本語法 1.標題和正文分隔線 至少三個連續等號,最高端標題 或者三個連續的減號,第二高階標題 2.標題字型大小 用 若干個 為字首 的個數對應於html中的 hx,即 1個 為h1的大小,6個 為h6 的大小 3...

Markdown 語法學習

進來深感記憶力不如從前,學習過的很多技能都已模糊,才慢慢思考自己不愛做筆記的陋習。自己經常在csdn上學習,遂想學習大牛們分享所學,順便備份。csdn上用markdown語法進行編輯,之前看過語法,一直沒有實踐,so,始於此!編輯器選擇 atom 語法參考 csdn寫部落格介面幫助檔案。寫在前面 空...