1. 程式人生 > >markdown 基本用法

markdown 基本用法

相對路徑 使用 表示 com 嵌套列表 方法 輸入法 img html語言

一、markdown 簡介

markdown 是一種輕量級的標註語言,可以以純文本的格式編寫文檔,也容易將文檔轉換成有效的XHTML或HTML。

二、markdown語法

2.1 段落與換行

  • 【段落】
      前後必須是空行(空白或者制表符等)
      相鄰的兩行文本如果中間沒有空行會顯示在同一行

  • 【換行】
      段落內部的換行需要在行尾加入至少兩個空格

2.2 標題

  • 【一級標題】
      使用數個等號(=)或者一個#號

  • 【二級標題】
      使用數個短線(-)或者兩個#號

  • 【三到六級標題】
      使用相對應數目的#號

  • 【格式規定】
      標題中左右兩側都可以加入#號
      標題兩側的空白字符不顯示,中間的空白字符顯示

2.3 引用

  • 【單行引用】
      每行前面加入一個大於號(>)

    單行引用的例子

  • 【多行引用】
      在每行前面加入一個大於號(>)
      如果引用多個空行,默認為引用會合並

    多行引用,含有大於號
    一下是四個空行,最終的顯示合並為一個空行

    多行引用

    以上的內容是一個空行產生的空白

  • 【嵌套引用】
      引用之中可以加入引用,在行的前面加入兩個大於號
      嵌套引用的兩個大於號和一個大於號之間應該加入一個空的引用

    嵌套引用,兩個大於號
    第一個嵌套引用

    中間有一個空的引用

    第二個嵌套引用

2.4 列表

  • 【無序列表】
      使用+ - * 都可以表示列表
    • 乘號*表示列表
    • 減號-
      表示列表
    • 加號+表示列表
  • 【有序列表】
      暫時沒有找到合適的方法,可以使用HTML語言直接寫
      有序列表<ol> <li> </li> </ol>
      ※ 不建議這麽做


    1. 有序列表第一項

    2. 有序列表第二項

    3. 有序列表第三項

  • 【嵌套列表】
      無序列表和有序列表可以互相嵌套

2.5 代碼

  • 【代碼塊】
      前後需要至少一個空行,且每行代碼前需要至少一個或四個空格
      代碼之間的空行最好是1行,否則視作兩個代碼塊

    code 代碼塊開始
    
    code 代碼塊結束
  • 【行內代碼】
      通過反引號(`)英文輸入法下tab鍵上面的鍵
      如code,這種情況一般表示按鍵Enter

2.6 分割線

  一行中使用三個或更多的* - _ 來添加分隔線
  多個字符之間可以有空格但不能有其他字符



2.7 超鏈接

  • 【行內鏈接】
      格式
    link text
    註:title text 可以使用單引號,也可使用雙引號 ,是鼠標放上去顯示的文字
      絕對路徑鏈接,如:
    google
      相對路徑鏈接,如:
    img.png
      包含標題的鏈接,如:
    google

  • 【參考式】
    可以將內容先卸載別的地方

markdown 基本用法