初識 Markdown

一、概述#

Markdown是一種輕量級的標記語言,他的目標是實現易讀易寫,一份使用Markdown格式撰寫的文件可以直接以純文本發布,并且看起來不會像是由許多標簽或格式指令所構成。Markdown的語法目標是:成為一種適用于網絡的書寫語言。HTML是一種發布的格式,Markdown是一種書寫的格式。Markdown的格式語法只涵蓋文本可以涵蓋的范圍。我們可以使用Markdown:

  • 整理知識,學習筆記
  • 發布日記,雜文,所見所想
  • 撰寫發布技術文稿(代碼支持)
  • 撰寫發布學術論文
markdown-logo

二、常用標記列舉

Markdown的語法全由一些符號所組成,這些符號經過精挑細選,其作用一目了然。

  • 各種header,如#, ##, ###, 等等,以及====, -----
  • 文字修飾:**__
  • 分隔符:-------
  • 列表:無序- 以及有序 1.
  • 圖片:![]()
  • 鏈接:[]()<>
  • 引用:>
  • 行內代碼:code, 以及代碼塊 ``` ```
  • 表格

三、常用標記詳解

1、標題

(1)類Setext形式:=(最高階標題) -(第二階標題),任何數量的 = 和 - 都可以,例如:

title1.png

注:在線Markdown編輯器上有效果,但Typore上沒有

(2)類Atx形式:在行首插入 1 到 6 個#,對應標題 1 到 6 階,例如:

title2.png

注:在線Markdown編輯器上#和文字中間需要有空格,而Typora上不需要加空格

2、區塊引用

在需要引用的首行最前面加上>;區塊引用可以嵌套,只要根據層次加上不同數量的>;引用的區塊也可以使用其他的Markdown語法,包括標題、列表、代碼區塊等,例如:

blockquotes.png

注:在線編輯器上沒有明顯效果,Typora效果如上圖

3、列表

(1)無序列表:使用*+,或是-作為列表標記,例如:

unorderedlist1.png

等同于:

unorderedlist2.png

也等同于:

unorderedlist3.png

注:在線編譯器標記與文字中間有空格才可以顯示,Typora不需要

(2)有序列表:使用數字接著一個英文句點,例如:

orderlist1.png

在列表標記上使用的數字不會影響輸出的結果,例如:

orderlist2.png

4、代碼區塊

(1)縮進 4 個空格或是 1 個制表符

code1.png

(2)多行代碼,用```包含代碼

code2.png

(3)行內代碼,用 ` 包起來

code3.png

5、分割線

在一行中用三個以上的*-_ 來建立一個分割線,行內不能有其他東西,但可以在星號或者減號中間插入空格,例如:

separator.png

6、鏈接

(1)行內式:方括號后緊跟圓括號并插入網址鏈接即可,若想要加上鏈接的title文字,在網址后面,用雙引號把title文字包起來即可,例如:

link.png

(2)參考式:在鏈接文字的括號后面再接上另一個方括號,而在第二個方括號里面要填入用以辨識鏈接的標記,可用于多個鏈接,例如:

link2.png

注:在線編譯器無效果,Typora有效果

7、強調

(1)粗體:雙_或雙*,例如:

bold.png

(2)斜體:單_或單*,例如:

italic.png

8、圖片

語法與加鏈接類似,在最前面加一個感嘆號,例如:

pic.png

9、表格

-分割第一行表格,用|分割每一列,例如:

table.png

四、待解決問題

  1. Markdown與HTML關系:

    不在Markdown涵蓋范圍之內的標簽,都可以直接在文檔里面用HTML撰寫,不需要額外標注這是HTML或是Markdown,只要直接加標簽就可以了。

    和處在HTML區塊標簽間不同,Markdown語法在HTML區段標簽間是有效的。

    學習發現有很多類似上述比較Markdown和HTML的介紹,不知道是不是因為還沒有太了解HTML,里面很多介紹不是很明白,拿來驗證又得不到相應的效果。

  2. 不同編輯器效果不同

    在使用Typora和免費在線markdown編輯器時發現,部分標簽顯示效果不同。具體不同在上一章節常用標記詳解中有注解。

五、參考資料

Markdown語法說明

為什么要用Markdown寫作

Mastering Markdown

Markdown的正確使用方式

Cmd Markdown 編輯閱讀器

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容