動態

詳情 返回 返回

最全面的 Markdown 語法參考手冊

全面掌握Markdown:本教程詳細介紹了Markdown的基本語法和擴展語法,包括標題、段落、列表、代碼、鏈接、圖片等,並提供實用技巧,助您快速上手,高效創建結構化文檔。無論您是編寫文檔、筆記、博客,還是進行內容創作,都能從中獲益。同時,本手冊還涵蓋了CommonMark規範,助您瞭解Markdown的底層原理。

文章目錄 

  • Markdown 基本語法

    • 標題 (Headings)")
    • 段落 (Paragraphs)")
    • 換行 (Line Breaks)")
    • 粗體 (Bold)")
    • 斜體 (Italic)")
    • 粗體和斜體 (Bold and Italic)")
    • 引用 (Blockquotes)")
    • 列表 (Lists)")

      • 有序列表 (Ordered Lists)")
      • 無序列表 (Unordered Lists)")
      • 嵌套列表 (Nested Lists)")
      • 在列表中添加其他元素
    • 代碼 (Code)")

      • 行內代碼 (Code Spans)")
      • 代碼塊 (Code Blocks)")
    • 分割線 (Horizontal Rules)")
    • 鏈接 (Links)")

      • 行內鏈接 (Inline Links)")
      • 格式化鏈接
      • 引用式鏈接 (Reference Links)")
    • 圖片 (Images)")
    • 轉義字符 (Escaping Characters)")
    • HTML 元素
  • Markdown 擴展語法

    • 刪除線 (Strikethrough)")
    • 任務列表 (Task Lists)")
    • 表情符號 (Emoji)")
    • 下標 (Subscript)")
    • 上標 (Superscript)")
    • 自動 URL 鏈接 (Automatic URL Linking)")
    • 表格 (Tables)")
    • 腳註 (Footnotes)")
    • 標題 ID (Heading IDs)")
    • 定義列表 (Definition Lists)")
    • 高亮 (Highlights)")
  • Markdown 技巧

    • 下劃線 (Underline)")
    • 縮進 (Indent)")
    • 居中 (Center)")
    • 顏色 (Color)")
    • 註釋 (Comments)")
    • 提示框 (Admonitions)")
    • 圖片大小 (Image Size)")
    • 圖片標題 (Image Captions)")
    • 鏈接目標 (Link Targets)")
    • 符號 (Symbols)")
    • 表格格式化 (Table Formats)")
    • 目錄 (Table of Contents)")
    • 視頻 (Videos)")
  • CommonMark 規範
  • 總結

Markdown 是一種輕量級的標記語言,它允許你使用易於閲讀和編寫的純文本格式來創建結構化的文檔。Markdown 的設計目標是儘可能地易讀易寫。它被廣泛應用於編寫文檔、筆記、博客、書籍以及在各種在線平台上進行內容創作。本教程手冊將全面介紹 Markdown 的基本語法和擴展語法,並提供一些實用的技巧,助你快速上手並精通 Markdown。

如果你還不知道 Markdown 是什麼,請閲讀文章:什麼是 Markdown?一文帶你瞭解這個內容創作者的效率神器

💡 為方便查看本手冊中的 Markdown 語法渲染效果,可以將 Markdown 語法示例複製到 「人言兑.md」 中進行預覽(人言兑.md 是一個使用 Markdown 語法編寫公眾號文章的在線編輯器,點擊 這裏 瞭解詳情)。

Markdown 基本語法

以下是 Markdown 的核心語法元素,它們在所有 Markdown 應用中都應該被支持。

標題 (Headings)

Markdown 語法中支持六級標題,通過在行首添加 # 符號來定義標題級別, # 的數量對應標題的級別。

  • # 一級標題 渲染為 <h1>一級標題</h1>
  • ## 二級標題 渲染為 <h2>二級標題</h2>
  • ### 三級標題 渲染為 <h3>三級標題</h3>
  • #### 四級標題 渲染為 <h4>四級標題</h4>
  • ##### 五級標題 渲染為 <h5>五級標題</h5>
  • ###### 六級標題 渲染為 <h6>六級標題</h6>

另外,還可以使用 = 和 - 來創建一級和二級標題:

一級標題
========

二級標題
--------

最佳實踐

  • 在 # 符號和標題文本之間添加一個空格。
  • 為了兼容性,在標題前後添加空行。

段落 (Paragraphs)

Markdown 語法中的段落由一個或多個文本行組成,使用空行來分隔不同的段落

這是第一段。

這是第二段。

最佳實踐不要使用空格或製表符縮進段落,除非段落位於列表中。

換行 (Line Breaks)

Markdown 語法中,在一行的末尾添加 兩個或多個空格,然後鍵入回車來創建一個換行。你也可以使用 <br> HTML 標籤來換行。

最佳實踐: 為了兼容性,建議使用尾隨空格或 <br> 標籤。

閲讀全文:最全面的 Markdown 語法參考手冊 - 阿小信的博客

user avatar
0 用戶, 點贊了這篇動態!

發表 評論

Some HTML is okay.