全面掌握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 語法參考手冊 - 阿小信的博客