Markdown 解析器

即時解析與預覽 Markdown。支援 GFM 表格、任務清單、刪除線等。所有處理均在您的瀏覽器中完成。

即時預覽 GFM 支援 客戶端處理

HTML 預覽將顯示在此...

如何使用 Markdown 解析器

1

撰寫 Markdown

在左側的編輯器中輸入或貼上您的 Markdown 內容。

2

即時預覽

在右側面板即時檢視渲染後的 HTML 輸出。

3

複製 HTML

複製產生的 HTML 以在您的專案中使用。

什麼是 Markdown?

Markdown 是一種輕量級標記語言,由 John Gruber 於 2004 年創建。它使用純文字格式語法,可轉換為 HTML 及許多其他格式。Markdown 廣泛應用於文件撰寫、README 檔案、部落格文章與訊息平台。

支援的語法

標題

使用 # 語法的 H1 到 H6

文字格式

粗體、斜體、刪除線、行內程式碼

列表與表格

有序、無序、任務清單與 GFM 表格

程式碼區塊

帶有語法高亮的圍欄程式碼區塊

常見問題

什麼是 GFM?

GFM(GitHub Flavored Markdown)是 GitHub 使用的 Markdown 方言。它在標準 Markdown 的基礎上增加了表格、任務清單、刪除線文字與自動連結等功能。

是否支援語法高亮?

解析器會渲染圍欄程式碼區塊。若要獲得帶有色彩的完整語法高亮,您可以搭配為程式碼元素設定樣式的 CSS 樣式表使用。

我可以用它來撰寫文件嗎?

可以!在編輯器中撰寫您的 Markdown,複製渲染後的 HTML,然後在您的文件、部落格或網站中使用。

Markdown、CommonMark 和 GFM 有什麼不同?

最初的 Markdown(2004 年)有許多邊界情況未明確定義,導致各種實作出現分歧。CommonMark 是解決這些問題的嚴謹規範;GFM(GitHub Flavored Markdown)則是 CommonMark 再加上擴充功能:表格、任務清單、刪除線、自動連結,以及 disallowed-raw-HTML 過濾器。本工具以 GFM 渲染,呈現結果與您在 GitHub 上看到的相同。

如何撰寫程式碼區塊和行內程式碼?

行內程式碼用單一反引號包住。圍欄區塊使用三個反引號,並在開頭一行加上語言標籤以啟用語法高亮——例如 ```python——或是將每一行縮排四個空格(較舊的語法,在清單內容易出問題)。當程式碼本身包含反引號時,也可以用三個波浪號作為圍欄。

可以在 Markdown 中嵌入原始 HTML 嗎?

可以——行內 HTML 標籤會直接傳遞到輸出結果。當過濾器啟用時,GFM 的 disallowed-raw-HTML 擴充功能只會移除少數危險標籤(script、style、iframe 等)。有兩點要注意:區塊級 HTML 所包裹的內容在內部會停止解析 Markdown 語法(空行會影響結果),而且任何使用者提交的 Markdown 都必須針對 XSS 做淨化處理,不能只靠標籤過濾。

GFM 的表格是怎麼運作的?

以管線符號分隔每一列,並在標題列下方放置一行連字號作為分隔線。冒號決定對齊方式:左端為「冒號加連字號」表示靠左對齊(預設值),兩端都有冒號表示置中對齊,右端為「連字號加冒號」表示靠右對齊。儲存格內不能包含區塊元素;要顯示字面上的管線符號,請跳脫為 \|;每列外側的管線符號可省略。更複雜的版面配置則需要原始 HTML 或文件引擎。

為什麼我的清單或巢狀項目渲染錯誤?

常見的原因有:縮排不一致(巢狀項目通常需要與父項目內容的第一個字元對齊)、段落與清單之間缺少空行,或是定位字元與空格混用。CommonMark 對這些情況都有精確的規範。將定位字元轉換為空格,並在清單前後加上空行,即可解決絕大多數巢狀問題。

{-- * External Resources Component(#18 Phase 3b 内容佐证工程) * 工具页「权威引用」区块:RFC / W3C / WHATWG / ECMA / IANA / 官方规范站 / Wikipedia。 * * - 接受 :slug 属性 → 经 config/tool-sources.php 家族矩阵渲染该工具的权威引用 * - slug 未命中映射时不渲染(无权威来源的工具静默跳过) * - 链接 title 保持英文(引用源专名);description 经 * common.resources.descriptions.{key} 本地化,lang 未命中回退英文(线上不裸奔) * - 链接保持 dofollow(rel="noopener noreferrer") * * @param string|null $slug --}}