Markdown 解析器
即時解析與預覽 Markdown。支援 GFM 表格、任務清單、刪除線等。所有處理均在您的瀏覽器中完成。
HTML 預覽將顯示在此...
如何使用 Markdown 解析器
撰寫 Markdown
在左側的編輯器中輸入或貼上您的 Markdown 內容。
即時預覽
在右側面板即時檢視渲染後的 HTML 輸出。
複製 HTML
複製產生的 HTML 以在您的專案中使用。
什麼是 Markdown?
Markdown 是一種輕量級標記語言,由 John Gruber 於 2004 年創建。它使用純文字格式語法,可轉換為 HTML 及許多其他格式。Markdown 廣泛應用於文件撰寫、README 檔案、部落格文章與訊息平台。
支援的語法
標題
使用 # 語法的 H1 到 H6
文字格式
粗體、斜體、刪除線、行內程式碼
列表與表格
有序、無序、任務清單與 GFM 表格
程式碼區塊
帶有語法高亮的圍欄程式碼區塊
常見問題
GFM(GitHub Flavored Markdown)是 GitHub 使用的 Markdown 方言。它在標準 Markdown 的基礎上增加了表格、任務清單、刪除線文字與自動連結等功能。
解析器會渲染圍欄程式碼區塊。若要獲得帶有色彩的完整語法高亮,您可以搭配為程式碼元素設定樣式的 CSS 樣式表使用。
可以!在編輯器中撰寫您的 Markdown,複製渲染後的 HTML,然後在您的文件、部落格或網站中使用。
最初的 Markdown(2004 年)有許多邊界情況未明確定義,導致各種實作出現分歧。CommonMark 是解決這些問題的嚴謹規範;GFM(GitHub Flavored Markdown)則是 CommonMark 再加上擴充功能:表格、任務清單、刪除線、自動連結,以及 disallowed-raw-HTML 過濾器。本工具以 GFM 渲染,呈現結果與您在 GitHub 上看到的相同。
行內程式碼用單一反引號包住。圍欄區塊使用三個反引號,並在開頭一行加上語言標籤以啟用語法高亮——例如 ```python——或是將每一行縮排四個空格(較舊的語法,在清單內容易出問題)。當程式碼本身包含反引號時,也可以用三個波浪號作為圍欄。
可以——行內 HTML 標籤會直接傳遞到輸出結果。當過濾器啟用時,GFM 的 disallowed-raw-HTML 擴充功能只會移除少數危險標籤(script、style、iframe 等)。有兩點要注意:區塊級 HTML 所包裹的內容在內部會停止解析 Markdown 語法(空行會影響結果),而且任何使用者提交的 Markdown 都必須針對 XSS 做淨化處理,不能只靠標籤過濾。
以管線符號分隔每一列,並在標題列下方放置一行連字號作為分隔線。冒號決定對齊方式:左端為「冒號加連字號」表示靠左對齊(預設值),兩端都有冒號表示置中對齊,右端為「連字號加冒號」表示靠右對齊。儲存格內不能包含區塊元素;要顯示字面上的管線符號,請跳脫為 \|;每列外側的管線符號可省略。更複雜的版面配置則需要原始 HTML 或文件引擎。
常見的原因有:縮排不一致(巢狀項目通常需要與父項目內容的第一個字元對齊)、段落與清單之間缺少空行,或是定位字元與空格混用。CommonMark 對這些情況都有精確的規範。將定位字元轉換為空格,並在清單前後加上空行,即可解決絕大多數巢狀問題。