推薦工具
Visual Studio Code (VS Code) - 強烈推薦
特點:微軟出品,免費、開源、跨平臺(Windows, macOS, Linux)。擁有海量插件市場。
編輯體驗:安裝 Markdown All in One 等插件后,可以獲得語法高亮、實時預覽、目錄生成、表格格式化等強大功能。
快捷鍵
快捷鍵大法(強烈推薦)
在打開的
.md
文件中,直接按下Ctrl + K
,然后松開,再按V
。效果:右側會分屏打開一個預覽窗口,并且實時同步你左側編輯的內容
編輯語法
基礎語法(最常用)
以下內容在絕大多數支持 Markdown 的平臺上均可通用:
1.標題(Headers)
使用 # 符號定義標題級別,1-6 個 # 分別對應 HTML 中的 <h1> 至 <h6> 標簽。
# 一級標題 (H1)
## 二級標題 (H2)
### 三級標題 (H3)
#### 四級標題 (H4)
##### 五級標題 (H5)
###### 六級標題 (H6)
實際效果:
一級標題 (H1)
二級標題 (H2)
三級標題 (H3)
2. 段落與換行 (Paragraphs and Line Breaks)
段落:使用空行分隔段落。
這是第一段落。這是第二段落。
換行:行尾添加兩個空格后回車,或使用空行(但后者不構成嚴格段落)。
第一行結尾包含兩個隱藏空格
第二行內容。
3. 強調 (Emphasis)
斜體 (Italic)
使用單個*
或_
包裹文本:
*斜體文本示例*
_另一種斜體表示方式_
粗體 (Bold)
使用雙*
或_
包裹文本:
**粗體文本示例**
__另一種粗體表示方式__
粗斜體 (Bold and Italic)
使用三*
或_
包裹文本:
***粗斜體文本示例***
___另一種粗斜體表示方式___
效果:
這是斜體文本
這是粗體文本
這是粗斜體文本
4. 列表 (Lists)
有序列表 (Ordered Lists)
使用數字加點號表示:
1. 第一項
2. 第二項
3. 第三項
無序列表 (Unordered Lists)
使用-
、*
或+
表示:
- 項目一
* 項目二
+ 項目三
嵌套列表
在子項目前使用2或4個空格縮進:
1. 第一項- 第一項的子項- 另一個子項
2. 第二項
效果演示:
- 第一項
- 第一項的子項
- 另一個子項
- 第二項
- 項目一
- 項目二
5. 鏈接 (Links)
行內鏈接
使用格式:[鏈接文本](URL "標題(可選)")
示例:
訪問 [Google](https://www.google.com) 搜索。
訪問 [Google](https://www.google.com "Google 主頁") 搜索。
引用式鏈接
適用于重復使用的鏈接,保持文檔整潔。
示例:
這是一個引用式鏈接 [Example][1] 的例子。[1]: http://example.com/ "Optional Title"
6. 圖片 (Images)
語法與鏈接類似,前面加!
號:
")
示例:

效果說明:
- 圖片URL有效時會顯示圖片
- 替代文本在圖片無法加載時顯示
7. 代碼 (Code)
行內代碼:使用單個反引號 ` 包裹內容。
示例:
使用 `printf()` 函數打印
代碼塊:使用三個反引號 ``` 包裹代碼,可在開頭指定語言實現語法高亮。
示例:
```python
def hello_world():print("Hello, World!")
```
效果: 使用 printf()
函數打印
def hello_world():print("Hello, World!")