Markdown語法筆記

Mon, 09 Dec 2024 14:05:07 +0000

概述

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. 有序清單子清單
  1. 有序清單子子清單

  - 無序清單
  - 無序清單
    - 無序清單子清單
      - 無序清單子子清單

  1. 有序清單
  2. 有序清單
     1. 有序清單子清單
        1. 有序清單子子清單

連結

連結名稱

[連結名稱]((https://google.com))

程式碼

1
2

var s = "JavaScript 語法高亮";
alert(s);

1
2

$s = "PHP 語法高亮";
echo $s;

```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語法 |
|:------:|:----------:|:------------:|
|  粗體  |  **粗體**  |  `**粗體**`  |
|  斜體  |   *斜體*   |   `*斜體*`   |
| 刪除線 | ~~刪除線~~ | `~~刪除線~~` |

表格生成器

Web on DowBlog