什麼是 Markdown
Markdown 是一種用純文字撰寫格式化文件的方式。只要在一般文字的前後加上幾個符號,就能標示標題、強調、清單、連結與程式碼,而且即使在轉換之前,文字本身依然易於閱讀。
它被用於 README 檔案、技術文件、筆記應用程式、聊天訊息,以及許多部落格工具。上方的編輯器會在您輸入時,顯示每一種語法呈現出來的樣子。
透過快速參考表學會標題、清單、連結、表格與程式碼區塊的 Markdown 語法,再到即時預覽編輯器中動手試試。
預覽
Markdown 能將純文字轉換成格式化的文字。這個段落包含 粗體、斜體 與 刪除線 文字,還有一些 行內程式碼。
第一個項目
第二個項目
巢狀項目
第一步
第二步
已完成的待辦事項
未完成的待辦事項
簡單的事就該保持簡單。
詳情請見 example.com。
| 水果 | 價格 |
|---|---|
| 蘋果 | 1.20 |
| 梨子 | 0.90 |
function greet(name) {
return "Hello, " + name;
}範例圖片
預覽在您的瀏覽器中執行。原始 HTML 會以文字顯示,圖片會以預留位置呈現,而且只有 http、https 與 mailto 連結可以點擊。
**bold text***italic text****bold and italic***~~crossed out~~First paragraph.
Second paragraph.First line\
Second line\*not italic\*# Heading 1## Heading 2### Heading 3###### Heading 6Heading 1
=========
Heading 2
---------- First item
- Second item
- Third item1. First item
2. Second item
3. Third item- Parent item
- Child item
- Child item- [x] Finished task
- [ ] Open task[link text](https://example.com)[link text](https://example.com "Tooltip")<https://example.com>`inline code``` code with a ` backtick `````
code block
``````js
console.log("Hi");
```> Quoted text> Quoted text
>> Nested quote---| Name | Qty |
| --- | --- |
| Apple | 3 |
| Pear | 5 || Left | Center | Right |
| :--- | :---: | ---: |
| a | b | c || Markdown | 用途 |
|---|---|
**bold text** | 粗體文字。前後各加兩個底線也可以。 |
*italic text* | 斜體文字。前後各加一個底線也可以。 |
***bold and italic*** | 使用三個星號,同時套用粗體與斜體。 |
~~crossed out~~ | 在文字前後各加兩個波浪號,為文字加上刪除線。 |
First paragraph.
Second paragraph. | 在文字區塊之間留一個空行,即可開始新的段落。 |
First line\
Second line | 在行尾加上反斜線或兩個空格,即可在同一個段落內換行。 |
\*not italic\* | 在 Markdown 符號前加上反斜線,就會顯示該符號本身。 |
# Heading 1 | 最上層的標題。井字號後面要加一個空格。 |
## Heading 2 | 第二層標題,用於主要章節。 |
### Heading 3 | 第三層標題,用於子章節。 |
###### Heading 6 | 最小的標題。層級從一個到六個井字號。 |
Heading 1
=========
Heading 2
--------- | 另一種寫法:在文字下一行加上等號表示第 1 層,加上連字號則表示第 2 層。 |
- First item
- Second item
- Third item | 項目符號清單。每一行以連字號、星號或加號開頭。 |
1. First item
2. Second item
3. Third item | 編號清單。每一行以數字加上句點開頭。 |
- Parent item
- Child item
- Child item | 將項目縮排兩個以上的空格,就能把它巢狀放在上一個項目之下。 |
- [x] Finished task
- [ ] Open task | 含有已勾選與未勾選方塊的待辦清單。 |
[link text](https://example.com) | 連結。方括號內放顯示的文字,圓括號內放網址。 |
[link text](https://example.com "Tooltip") | 附有提示文字的連結,提示文字以引號寫在網址後面。 |
<https://example.com> | 用角括號括住網址,就能把它變成連結。 |
| 用角括號括住電子郵件地址,就能把它變成郵件連結。 | |
 | 圖片。寫法和連結一樣,只是前面多一個驚嘆號;方括號內的文字用來描述圖片。 |
`inline code` | 句子中的程式碼,以反引號括住。 |
`` code with a ` backtick `` | 程式碼本身含有反引號時,請改用兩個反引號括住。 |
```
code block
``` | 夾在兩行三個反引號之間的程式碼區塊。區塊內的文字會照您輸入的樣子保留。 |
```js
console.log("Hi");
``` | 在開頭的反引號後面加上語言名稱,讓編輯器能以顏色標示程式碼語法。 |
> Quoted text | 引言文字。在行首加上大於符號。 |
> Quoted text
>> Nested quote | 再加一個大於符號,就能在引言中再引用。 |
--- | 分隔線。在單獨一行放三個以上的連字號、星號或底線。 |
| Name | Qty |
| --- | --- |
| Apple | 3 |
| Pear | 5 | | 表格。以直線符號分隔各欄,並在標題列下方加上一列連字號。 |
| Left | Center | Right |
| :--- | :---: | ---: |
| a | b | c | | 分隔列中的冒號可讓該欄靠左、置中或靠右對齊。 |
Markdown 是一種用純文字撰寫格式化文件的方式。只要在一般文字的前後加上幾個符號,就能標示標題、強調、清單、連結與程式碼,而且即使在轉換之前,文字本身依然易於閱讀。
它被用於 README 檔案、技術文件、筆記應用程式、聊天訊息,以及許多部落格工具。上方的編輯器會在您輸入時,顯示每一種語法呈現出來的樣子。
大多數問題出在空格與空行,而不是符號本身。
基本語法是一樣的。標題、強調、清單、連結與程式碼幾乎在各處都遵循 CommonMark 標準。表格、待辦清單與刪除線則是由 GitHub 帶動普及的擴充語法,因此少數應用程式並不支援。
預覽功能是刻意加以限制的。原始 HTML 會以文字顯示,圖片會以附有標籤的預留位置呈現而不會被下載,而且只有 http、https 與 mailto 連結可以點擊。
不會。預覽是在您的瀏覽器中產生的,文字不會被上傳或儲存。