markdown 基本語法指南
markdown 是一種輕量級的標記語言,廣泛應用於文件撰寫、部落格等平台。它簡單易學,能有效地格式化文字。本文將介紹最常用的 Markdown 語法,適合初學者快速上手。
1. 標題
在 Markdown 中,標題使用 # 符號來表示,# 的數量決定了標題的層級(H1 到 H6)。例如:
# H1 標題
## H2 標題
### H3 標題
#### H4 標題
##### H5 標題
###### H6 標題顯示效果:
這是一級標題
這是二級標題
2. 段落與換行
段落不需要特別的標記,只需在文字間空一行即可。在同一行內按兩次空格則可以換行。
這是一個段落。
這是另一個段落。顯示效果:
這是一個段落。
這是一段有兩個空格後的換行。
這是新段落。
3. 強調與字體樣式
使用 * 或 _ 來表示斜體,使用 ** 或 __ 來表示粗體。
*斜體* 或 _斜體_
**粗體** 或 __粗體__顯示效果:
這是 粗體文字,這是 斜體文字。
4. 列表
Markdown 支援無序和有序列表。無序列表使用 -、* 或 +。有序列表使用數字和點號。
- 項目一
- 項目二
1. 項目一
2. 項目二顯示效果:
- 第一項
- 第二項
- 子項目一
- 子項目二
- 子項目三
- 子項目四
5. 連結與圖片
連結使用 [顯示文字](網址) 格式。圖片的語法類似,但前面需要加上 !。
[Hexo 官方網站](https://hexo.io)
顯示效果:
6. 程式碼區塊
行內程式碼使用反引號 ` 括起來,多行程式碼區塊則使用三個反引號 。
`行內程式碼`
```
多行程式碼區塊
```
顯示效果:
行內程式碼
多行程式碼區塊
7. 引用與水平線
引用文字使用 >,水平線則使用 ---、*** 或 ___。
> 這是一段引用。
---
> 這是一段多行引用的範例,
> 它展示了如何處理超過一行的引用。
> 可以在每行結尾使用雙空格來進行換行。顯示效果:
這是一段引用。
這是一段多行引用的範例,
它展示了如何處理超過一行的引用。
可以在每行結尾使用雙空格來進行換行。
8. 組合語法
Markdown 支援將多個語法組合使用,例如在列表中加入引用或程式碼:
1. 第一項
- 子項一
- 子項二
2. 第二項
> 引用文字
```markdown
程式碼範例
```顯示效果:
- 第一項
- 子項一
- 子項二
- 第二項
引用文字
程式碼範例
9. 常見情境語法組合
9.1 引用與強調組合
引用和強調文字常用於強調重要信息:
> **注意:** 在安裝 Hexo 時,請確保 Node.js 已經更新到最新版本。顯示效果:
注意: 在安裝 Hexo 時,請確保 Node.js 已經更新到最新版本。
9.2 列表與連結組合
列表中常會包含連結,以方便讀者進一步了解某個主題:
- [Markdown 官方網站](https://daringfireball.net/projects/markdown/)
- [Hexo 文件](https://hexo.io/docs/)顯示效果:
10. 額外進階語法
10.1 表格
Markdown 也支援表格語法,用來展示結構化數據。
| 表頭一 | 表頭二 | 表頭三 |
| ------ | ------ | ------ |
| 單元格一 | 單元格二 | 單元格三 |顯示效果:
| 表頭一 | 表頭二 | 表頭三 |
|---|---|---|
| 單元格一 | 單元格二 | 單元格三 |
10.2 勾選框列表
可以使用 [ ] 或 [x] 來表示待辦事項列表。
- [ ] 待辦事項一
- [x] 已完成事項顯示效果:
- 待辦事項一
- 已完成事項
結語
Markdown 是非常靈活且易學的標記語言,無論是寫作還是技術文件,都能夠幫助您快速生成格式化的內容。希望這份指南能幫助您更好地掌握 Markdown 的基礎語法。
