Markdown 到 HTML

Markdown 到 HTML 轉換器將 Markdown 原始碼(自述文件、變更日誌、部落格草稿、一組發布說明)轉換為瀏覽器或 CMS 實際呈現的 HTML。在左側貼上或鍵入 Markdown,您會在右側獲得語義 HTML:標題變為 h1 veholdh6,圍欄程式碼變為 pre,帶有語言類別的程式碼變為 ul 和 ol,以及 GitHub 擴充功能(例如表格、任務清單和刪除線)的處理方式GitHub 呈現它們的方式。

Markdown 是一種純文字書寫格式,而不是顯示格式。它出現在頁面上的任何位置 - 文檔網站、靜態部落格、電子郵件範本、僅接受 HTML 的 CMS 欄位 - 必須先編譯它。在瀏覽器中執行此操作,而不是在建置中拉動解析器或將草稿貼上到您無法控制的服務中,是標記出來並繼續進行的最快方法。

一切都運行客戶端。 轉換器是一個手寫解析器，而不是一個包裹在遠端 API 中，因此您的未發布的帖子、內部文件和私人發行說明永遠不會離開頁面。 切換 GitHub Flavored Markdown、標題錨點 ID、單線中斷和原始 HTML 傳遞，然後複製 HTML、下載 .html 檔案或取得產生的目錄。

Markdown 允許原始 HTML 內聯,這使得安全問題成為現實而不是理論:包含腳本標籤的文件是有效的 Markdown,傳遞它的轉換器會產生在渲染時運行的 HTML。因此,預設情況下會轉義此處的輸出,因此來自不受信任來源的 Markdown 檔案無法將標記走私到您的頁面中。如果您正在轉換自己的內容並希望保留原始 HTML,則這是故意的選擇而不是預設的。需要知道的另一件事是 Markdown 沒有單一規範。 GitHub Flavored Markdown 在此實現,它涵蓋表格、任務清單、刪除線和圍欄程式碼,這些是擴充功能而不是原始語法的一部分,因此嚴格的 CommonMark 渲染器不會顯示它們。