markdown語法之列表與縮進


  1. 在markdown語法中, 用*或+或-在行首表示無序列表。在這些符號之后應該空一格然后輸入內容。
    例如 + 無序列表 * 無序列表 - 無序列表
    會被markdown語法渲染為
  • 無序列表
  1. 列表嵌套

    • 如果希望一個沒有加列表點的段落和一個列表項的內容顯示對齊。需要把非列表段落行首打一個Tab(或者四個Space,以后使用Tab的地方類似,不再強調)。
    * 我們需要……
    

    還沒說完……
    以及……

    PS:……

    顯示為

    • 我們需要……

      還沒說完……
      以及……

    PS:……

    使用該功能的時候特別注意不要多敲Tab或Space。一行行首存在Tab(或行首Space大於等於4個),且不是多層列表嵌套或列表對齊,就會識別為代碼段落。

    • 如果希望一個列表作為另一個列表的子項目同樣可以使用Tab實現。
    * 做一些事
    * 做另一些事
      + 第一步
      + 第二步
    * 另外做……
    
          
          
         
         
                 

    顯示為

    • 做一些事
    • 做另一些事
      • 第一步
      • 第二步
    • 另外做……

    源代碼中使用什么符號和渲染的結果沒有直接關系。把上邊的+換成*顯示效果也一樣。但是這樣寫可以增強源代碼結構性。實際使用中,盡量不要同級使用不同符號。同理對於不同級別盡量使用不同符號。

    如果列表、代碼段落、引用相互嵌套的時候,一定注意數清楚每行應該用幾個Tab。

  2. 有序列表:用數字加‘.’在行首表示有序列表。在‘.’后應該空一格再寫內容。

      有如下3點:  
      1. 無序  
      2. 有序  
      3. 縮進
    
          
          
         
         
                 

    顯示為

    有如下3點:

    1. 無序
    2. 有序
    3. 縮進

    也可以使用ASCII中的)代替.符號,但是和無序列表一樣盡量不要在同一級別混用兩種樣式。

    有序列表的對齊和分級與無序列表類似。但是額外注意有序列表序號不要寫亂,雖然有時候渲染會自動糾正序號。

  3. 如果一行被標記為列表項。那么不論這一行之前有沒有空行,本行和上一行都被視為兩個段落。但是如果后邊沒有空行且下一行不是列表項,則本行仍可與后一行屬於同一段落。

    aaa
    * 本行后邊沒有雙空格
    bbb
    

    aaa

    • 本行后邊有雙空格
      bbb

    顯示為

    aaa

    • 本行后邊沒有雙空格
      bbb

    aaa

    • 本行后邊有雙空格
      bbb
  4. 關於縮進的“容忍度”

    • 行首如果有大於等於4個Space,本行被視為代碼段落。代碼段落選然后會原樣輸出所有符號。

    • 標題標記,列表標記符號之后除了必須的那一個Space,如果還有大於等於4分割Space,那么原本標記的格式會失效,認為是后接了一個代碼段落。(后邊的引用塊也有類似情況。)

原文地址:https://blog.csdn.net/qq_33229669/article/details/81610939


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM