概述
Markdown 目標是實現「易讀易寫」，語法全由標點符號所組成
Markdown 跟 HTML 差別
| 比較項目 | Markdown | HTML |
|---|---|---|
| 定位與用途 | 一種輕量級的標記語言，設計用於簡潔地編寫純文本，然後轉換為格式化的內容。 | 超文本標記語言，用於定義網頁的結構和內容，是網站開發的基礎。 |
| 語法與可讀性 | 使用簡單的符號（如 # 表示標題，* 表示列表），即使不渲染也易於閱讀。 |
使用標籤（如 <h1>、<p>）來標記內容，源代碼包含大量標籤，閱讀起來較為複雜。 |
| 學習難度 | 學習曲線平緩，適合快速上手和編寫文檔。 | 需要理解各種標籤、屬性和網頁結構，學習成本較高。 |
| 功能與靈活性 | 支持基本的文本格式化，功能有限，適用於簡單文檔。 | 功能豐富，支持複雜的布局、多媒體、表單等，可與 CSS、JavaScript 結合實現動態效果。 |
| 轉換與渲染 | 需要轉換為 HTML 或其他格式才能被瀏覽器正確顯示。 | 瀏覽器原生支持，直接解析和渲染。 |
| 使用場景 | 撰寫 README 文件、技術文檔、博客文章等。 | 開發網頁和 Web 應用程序，是前端開發的基礎。 |
| 可擴展性 | 通過插件或擴展可以增加功能，但受限於 Markdown 的設計理念。 | 高度可擴展，通過各種框架和庫可以實現幾乎任何功能。 |
| 與其他技術的結合 | 通常與版本控制系統（如 Git）和協作平台（如 GitHub）結合使用。 | 可與 CSS、JavaScript 結合，構建完整的前端應用。 |
| 社區與支持 | 有廣泛的社區支持，許多工具和平台都支持 Markdown。 | 作為網頁開發的基礎技術，擁有龐大的開發者社區和資源。 |
行內 HTML
舉例來說，在 Markdown 文件裡加上一段 HTML 表格：
This is a regular paragraph.
<table>
<tr>
<td>Foo</td>
</tr>
</table>
This is another regular paragraph.
Markdown 語法在 HTML 區塊標籤中將不會被進行處理。
語法筆記
主標題
標題的語法
標題
===
副標題
副標
---
字體大小
# H1
## H2
### H3
#### H4
##### H5
字體效果
斜體字 粗體字 斜粗體
刪除線正常^上標^ 正常下標==螢光筆記==
*斜體字*
**粗體字**
***斜粗體***
~~刪除線~~
正常^上標^
正常~下標~
==螢光筆記==
引文
縮排語法 第一層
第二層
第三層
>縮排語法
>第一層
>>第二層
>>>第三層
標號
- 數字標號
- 數字標號
- 數字標號
- 其他標號
- 其他標號
-
其他標號
1. 數字標號 2. 數字標號 3. 數字標號 - 其他標號 + 其他標號 * 其他標號
清單
- 無序清單
- 無序清單
- 無序清單子清單
- 無序清單子子清單
- 無序清單子清單
- 有序清單
- 有序清單
- 有序清單子清單
- 有序清單子子清單
- 有序清單子清單
- 無序清單
- 無序清單
- 無序清單子清單
- 無序清單子子清單
1. 有序清單
2. 有序清單
1. 有序清單子清單
1. 有序清單子子清單
連結
[連結名稱]((https://google.com))
程式碼
|
|
|
|
```javascript
var s = "JavaScript 語法高亮";
alert(s);
```
```php
$s = "PHP 語法高亮";
echo $s;
```
表格
每個標頭元件都要用至少三個破折號+直線分隔開來，預設為置左。
冒號可以用來標示欄位的對齊方式。
| 表頭1 | 表頭2 | 表頭3 |
|---|---|---|
| 左1 | 中1 | 右1 |
| 左2 | 中2 | 右2 |
| 左3 | 中3 | 右3 |
當然，也可以在表格內加入樣式
| 功能 | 效果 | Markdown語法 |
|---|---|---|
| 粗體 | 粗體 | **粗體** |
| 斜體 | 斜體 | *斜體* |
| 刪除線 | ~~刪除線~~ |
每個標頭元件都要用至少三個`破折號`+`直線`分隔開來，預設為置左。
`冒號`可以用來標示欄位的對齊方式。
| 表頭1 | 表頭2 | 表頭3 |
|-------|:-----:|------:|
| 左1 | 中1 | 右1 |
| 左2 | 中2 | 右2 |
| 左3 | 中3 | 右3 |
當然，也可以在表格內加入樣式
| 功能 | 效果 | Markdown語法 |
|:------:|:----------:|:------------:|
| 粗體 | **粗體** | `**粗體**` |
| 斜體 | *斜體* | `*斜體*` |
| 刪除線 | ~~刪除線~~ | `~~刪除線~~` |