在 Markdown 與 HTML 之間互相轉換
這個轉換器的用途
Markdown 是以純文字書寫的標記語法,HTML 則是瀏覽器實際呈現的標記。這項工具讓內容在兩者之間雙向轉換。貼上 Markdown,就能得到已內嵌樣式的 HTML;貼上 HTML,工具會順著標籤還原成乾淨的 Markdown。整個過程都由內建的剖析器處理,因此不必架設建置流程,也不用安裝任何函式庫,就能直接轉換 README、文章草稿或文件片段。
什麼時候用
當你用 Markdown 寫的筆記得放進只認得 HTML 的地方 — CMS 欄位、電子郵件範本、頁面的某個區塊 — 又不想手動敲標籤時,它就派得上用場。反方向則適合你接手了一份 HTML,卻想繼續以 Markdown 來編輯的情況。四種主題(GitHub、Minimal、Classic、Modern)讓你先大致預覽成品樣貌,複製前挑一個調性。即時預覽與原始碼檢視並列在一起,版面呈現和實際標記都能當場核對。
實際範例
輸入 `# 版本說明`,轉換器就會產生一個 `<h1>` 標題。用兩個星號包住的 `**已發布**` 會變成 `<strong>已發布</strong>`;以三個反引號開頭的區塊會轉成一組 `<pre><code>`,並把語言名稱記錄成類別。清單、以 `[顯示文字](url)` 形式寫的連結、圖片、引用,以及 `---` 水平線,也都對應到各自的 HTML。反向轉換時,每個 `<h1>` 會變回 `#`、每個 `<strong>` 會變回 `**`,結構在來回之間依然保持不變。
注意事項與特例
剖析器涵蓋的是你平常手寫的 Markdown — 標題、強調、行內程式碼與程式碼區塊、連結、圖片、清單、引用、水平線 — 而非所有擴充語法。Markdown 表格不會被解讀,用直線畫的表格會原封不動地留成純文字;若文件需要表格,請直接以 HTML 撰寫。樣式是以行內 `style` 屬性套在每個元素上,而不是另外一份樣式表,正因如此,把輸出貼進會濾掉 `<style>` 區塊的電子郵件或 CMS 欄位,外觀也能維持。此外,每種主題都會依頁面自動準備淺色與深色兩種版本。