2025年2月21日 星期五

Markdown 語法介紹與範例

 Markdown 是一種輕量級的標記語言,主要用來撰寫格式化的文本,並且可以輕鬆轉換成 HTML。它通常用於 README 文件、部落格文章、技術文件等。

1. 標題 (Headings)

使用 # 表示標題,# 的數量決定標題的層級。

markdown
# 這是 H1 標題 ## 這是 H2 標題 ### 這是 H3 標題 #### 這是 H4 標題 ##### 這是 H5 標題 ###### 這是 H6 標題

2. 粗體、斜體、刪除線

markdown
**這是粗體** *這是斜體* ~~這是刪除線~~

顯示結果: 這是粗體
這是斜體
這是刪除線


3. 區塊引用 (Blockquote)

markdown
> 這是一個引用 >> 這是巢狀引用

顯示結果:

這是一個引用

這是巢狀引用


4. 代碼區塊 (Code Block)

行內程式碼

使用 ` 符號標記行內程式碼:

markdown
這是一段 `inline code`

顯示結果:
這是一段 inline code

區塊程式碼

使用 3 個反引號 (```) 或 4 個縮排空格來表示程式碼區塊:

markdown

這是一個程式碼區塊


也可以指定程式語言:

markdown
```python print("Hello, World!")
bash
顯示結果: ```python print("Hello, World!")

5. 列表 (Lists)

無序列表

使用 -+*

markdown
- 項目 1 - 項目 2 - 子項目 2.1 - 子項目 2.2 * 項目 3

顯示結果:

  • 項目 1
  • 項目 2
    • 子項目 2.1
    • 子項目 2.2
  • 項目 3

有序列表

使用數字:

markdown
1. 項目 1 2. 項目 2 3. 項目 3

顯示結果:

  1. 項目 1
  2. 項目 2
  3. 項目 3

6. 超連結 (Links)

markdown
[Google](https://www.google.com)

顯示結果:
Google


7. 圖片 (Images)

markdown
![替代文字](https://example.com/image.jpg)

顯示結果:


8. 水平線 (Horizontal Line)

使用 ---***

markdown
---

顯示結果:


9. 表格 (Tables)

markdown
| 姓名 | 年齡 | 城市 | |------|-----|------| | 小明 | 25 | 台北 | | 小美 | 23 | 高雄 |

顯示結果:

姓名年齡城市
小明25台北
小美23高雄

10. 待辦清單 (Task Lists)

markdown
- [x] 已完成項目 - [ ] 未完成項目 - [ ] 另一個未完成項目

顯示結果:

  • 已完成項目
  • 未完成項目
  • 另一個未完成項目

結論

Markdown 是一種簡單易懂的標記語言,適合用於文件撰寫、部落格文章、技術文件等。如果你需要撰寫簡單格式化的內容,Markdown 是很好的選擇。

沒有留言:

張貼留言