Markdown 是一種輕量級的標記語言,它的目標是讓人們“使用易於閲讀、易於編寫的純文本格式編寫文檔,然後可以轉換成有效的 HTML 文檔”。
它的核心哲學是:可讀性至上。也就是説,即使不經過渲染,Markdown 源文件本身也應該清晰易讀。
下面我將分模塊為你詳細講解最常用和最重要的 Markdown 語法。
1. 標題
標題是通過在文字前添加 # 來創建的。# 的數量代表了標題的級別(從 1 到 6)。
語法:
# 這是一級標題
## 這是二級標題
### 這是三級標題
#### 這是四級標題
##### 這是五級標題
###### 這是六級標題
效果:
這是一級標題
這是二級標題
這是三級標題
小技巧: 你也可以使用 =(用於一級標題)和 -(用於二級標題)在標題下方劃線。
這是一級標題
=============
這是二級標題
-------------
2. 段落與換行
段落: 只需用一個或多個空行來分隔段落。
換行: 在 Markdown 中,直接按回車鍵並不會換行。要實現換行,你可以在行尾添加 兩個或多個空格,然後按回車鍵,或者直接使用一個空行來開始新的段落(這樣間距會更大)。
語法:
這是第一個段落。它有很多文字,但都連在一起。
這是第二個段落。這行後面有兩個空格(你看不見)
然後我就換行了,但還在同一個段落裏,只是新起了一行。
3. 強調(粗體與斜體)
語法:
*這是斜體文本* 或者 _這也是斜體文本_
**這是粗體文本** 或者 __這也是粗體文本__
***這是粗斜體文本*** 或者 ___這也是粗斜體___
效果:
這是斜體文本 或者 這也是斜體文本
這是粗體文本 或者 這也是粗體文本
這是粗斜體文本 或者 這也是粗斜體
4. 列表
無序列表
使用 *、+ 或 - 作為列表標記。
語法:
- 項目一
- 項目二
- 子項目二點一(縮進兩個或四個空格)
- 子項目二點二
- 項目三
效果:
- 項目一
- 項目二
- 子項目二點一
- 子項目二點二
- 項目三
有序列表
使用數字接着一個英文句點。
語法:
1. 第一項
2. 第二項
3. 第三項
效果:
- 第一項
- 第二項
- 第三項
注意: 你寫的數字順序不影響最終輸出,渲染器會自動按 1,2,3... 排序。
5. 鏈接與圖片
鏈接
語法:
[鏈接文本](鏈接的URL "可選的標題(鼠標懸停顯示)")
示例:
訪問 [百度](https://www.baidu.com) 搜索。
我的 [個人網站](https://example.com "歡迎光臨")。
效果:
訪問 百度 搜索。
圖片
語法與鏈接幾乎一樣,只是在最前面加一個 !。
語法:

示例:

6. 引用
使用 > 符號來表示引用。
語法:
> 這是一個單段落的引用。
> 這一行也在同一個引用塊裏。
> 這是另一個引用塊。
> 多行引用也很方便。
>
> 甚至在引用裏可以使用 **其他 Markdown 語法**。
效果:
這是一個單段落的引用。 這一行也在同一個引用塊裏。
這是另一個引用塊。 多行引用也很方便。
甚至在引用裏可以使用 其他 Markdown 語法。
7. 代碼
行內代碼
用一個反引號 ` 包裹代碼。
語法:
使用 `printf()` 函數來打印輸出。
效果:
使用
printf()函數來打印輸出。
代碼塊
用三個反引號 ``` 包裹一段代碼。你還可以在開始的反引號後指定語言,以實現語法高亮。
語法:
```python
# 這是一個 Python 代碼塊
def hello():
print("Hello, Markdown!")
```
效果(帶高亮):
# 這是一個 Python 代碼塊
def hello():
print("Hello, Markdown!")
8. 表格
使用連字符 - 來分隔表頭,使用管道 | 來分隔列。
語法:
| 左對齊 | 居中對齊 | 右對齊 |
| :--- | :---: | ---: |
| 單元格 | 單元格 | 單元格 |
| 內容 | 內容 | 內容 |
效果:
| 左對齊 | 居中對齊 | 右對齊 |
|---|---|---|
| 單元格 | 單元格 | 單元格 |
| 內容 | 內容 | 內容 |
説明:
:---表示左對齊:---:表示居中對齊---:表示右對齊
9. 分隔線
你可以使用三個或更多的星號 ***、連字符 --- 或下劃線 ___ 來創建一條水平分隔線。
語法:
***
---
___
效果: 上面每個例子都會產生一條水平線。
10. 轉義字符
如果你想要顯示 Markdown 語法中的特殊字符(如 *、#、_ 等),你需要在它們前面加上反斜槓 \。
語法:
\*這不是斜體\*
\# 這不是標題
效果:
*這不是斜體* # 這不是標題
總結
Markdown 的核心語法就是這些,簡單易學,但功能強大。它廣泛應用於:
- 編寫文檔(如 GitHub 的
README.md) - 撰寫博客和文章
- 在論壇和社區中發帖
- 記筆記
許多平台(如 GitHub、GitLab、Notion、Typora、VS Code 等)都對 Markdown 提供了完美的支持。
結束語 Flutter是一個由Google開發的開源UI工具包,它可以讓您在不同平台上創建高質量、美觀的應用程序,而無需編寫大量平台特定的代碼。我將學習和深入研究Flutter的方方面面。從基礎知識到高級技巧,從UI設計到性能優化,歡飲關注一起討論學習,共同進入Flutter的精彩世界!