WebGroundwebground.app
資訊與指南 · 開發參考

Markdown 語法速查表(附即時預覽)

透過快速參考表學會標題、清單、連結、表格與程式碼區塊的 Markdown 語法,再到即時預覽編輯器中動手試試。

即時預覽編輯器

405 / 20,000

預覽

歡迎使用 Markdown

Markdown 能將純文字轉換成格式化的文字。這個段落包含 粗體、斜體 與 刪除線 文字,還有一些 行內程式碼。

清單
  • 第一個項目

  • 第二個項目

    • 巢狀項目

  1. 第一步

  2. 第二步

  • 已完成的待辦事項

  • 未完成的待辦事項

引言、連結與表格

簡單的事就該保持簡單。

詳情請見 example.com。

水果價格
蘋果1.20
梨子0.90
js
function greet(name) {
  return "Hello, " + name;
}

範例圖片

預覽在您的瀏覽器中執行。原始 HTML 會以文字顯示,圖片會以預留位置呈現,而且只有 http、https 與 mailto 連結可以點擊。

語法參考

顯示 30 / 30 筆
  • **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>
    用途
    用角括號括住網址,就能把它變成連結。
  • 用途
    用角括號括住電子郵件地址,就能把它變成郵件連結。
  • ![alt text](https://example.com/image.png)
    用途
    圖片。寫法和連結一樣,只是前面多一個驚嘆號;方括號內的文字用來描述圖片。
  • `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

Markdown 是一種用純文字撰寫格式化文件的方式。只要在一般文字的前後加上幾個符號,就能標示標題、強調、清單、連結與程式碼,而且即使在轉換之前,文字本身依然易於閱讀。

它被用於 README 檔案、技術文件、筆記應用程式、聊天訊息,以及許多部落格工具。上方的編輯器會在您輸入時,顯示每一種語法呈現出來的樣子。

寫出整潔 Markdown 的訣竅

大多數問題出在空格與空行,而不是符號本身。

  • 標題的井字號後面與清單符號後面都要加一個空格。
  • 在標題、清單、引言與程式碼區塊的前後各留一個空行。
  • 將巢狀清單項目縮排,使其與上一層項目的文字對齊。
  • 在 * 或 _ 這類符號前面加上反斜線,就能照原樣顯示它。

常見問題 (FAQ)

Markdown 在每個地方看起來都一樣嗎?+

基本語法是一樣的。標題、強調、清單、連結與程式碼幾乎在各處都遵循 CommonMark 標準。表格、待辦清單與刪除線則是由 GitHub 帶動普及的擴充語法,因此少數應用程式並不支援。

為什麼預覽不會執行我的 HTML,也不會載入我的圖片?+

預覽功能是刻意加以限制的。原始 HTML 會以文字顯示,圖片會以附有標籤的預留位置呈現而不會被下載,而且只有 http、https 與 mailto 連結可以點擊。

我輸入的文字會被傳送到任何地方嗎?+

不會。預覽是在您的瀏覽器中產生的,文字不會被上傳或儲存。

探索更多 WebGround 工具

查看全部