在這裏插入圖片描述

Markdown 是一種輕量級的標記語言,它的目標是讓人們“使用易於閲讀、易於編寫的純文本格式編寫文檔,然後可以轉換成有效的 HTML 文檔”。

它的核心哲學是:可讀性至上。也就是説,即使不經過渲染,Markdown 源文件本身也應該清晰易讀。

下面我將分模塊為你詳細講解最常用和最重要的 Markdown 語法。


1. 標題

標題是通過在文字前添加 # 來創建的。# 的數量代表了標題的級別(從 1 到 6)。

語法:

# 這是一級標題
## 這是二級標題
### 這是三級標題
#### 這是四級標題
##### 這是五級標題
###### 這是六級標題

效果:

這是一級標題

這是二級標題

這是三級標題

小技巧: 你也可以使用 =(用於一級標題)和 -(用於二級標題)在標題下方劃線。

這是一級標題
=============

這是二級標題
-------------

2. 段落與換行

段落: 只需用一個或多個空行來分隔段落。

換行: 在 Markdown 中,直接按回車鍵並不會換行。要實現換行,你可以在行尾添加 兩個或多個空格,然後按回車鍵,或者直接使用一個空行來開始新的段落(這樣間距會更大)。

語法:

這是第一個段落。它有很多文字,但都連在一起。

這是第二個段落。這行後面有兩個空格(你看不見)  
然後我就換行了,但還在同一個段落裏,只是新起了一行。

3. 強調(粗體與斜體)

語法:

*這是斜體文本* 或者 _這也是斜體文本_

**這是粗體文本** 或者 __這也是粗體文本__

***這是粗斜體文本*** 或者 ___這也是粗斜體___

效果:

這是斜體文本 或者 這也是斜體文本

這是粗體文本 或者 這也是粗體文本

這是粗斜體文本 或者 這也是粗斜體


4. 列表

無序列表

使用 *+- 作為列表標記。

語法:

- 項目一
- 項目二
  - 子項目二點一(縮進兩個或四個空格)
  - 子項目二點二
- 項目三

效果:

  • 項目一
  • 項目二
    • 子項目二點一
    • 子項目二點二
  • 項目三
有序列表

使用數字接着一個英文句點。

語法:

1. 第一項
2. 第二項
3. 第三項

效果:

  1. 第一項
  2. 第二項
  3. 第三項

注意: 你寫的數字順序不影響最終輸出,渲染器會自動按 1,2,3... 排序。


5. 鏈接與圖片

鏈接

語法:

[鏈接文本](鏈接的URL "可選的標題(鼠標懸停顯示)")

示例:

訪問 [百度](https://www.baidu.com) 搜索。
我的 [個人網站](https://example.com "歡迎光臨")。

效果:

訪問 百度 搜索。

圖片

語法與鏈接幾乎一樣,只是在最前面加一個 !

語法:

![圖片的替代文本(如果圖片無法顯示則顯示此文字)](圖片的URL "可選的標題")

示例:

![Markdown 標誌](https://markdown-here.com/img/icon256.png "一個標誌")

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的精彩世界!