UltKit

HTML 轉 Markdown 轉換器

HTML 是內容傳遞的格式,而越來越多人偏好用 Markdown 撰寫和保存內容。這個轉換器能把 .html 檔案轉成易讀的 .md 文字,讓部落格文章庫、說明中心或存下的文章順利搬到靜態網站、筆記庫或 Git 儲存庫。

文件轉換器

或將PDF, DOC, DOCX … 檔案拖曳到這裡 ·

每個檔案最大 95 MB· 最多 20 個檔案· 30 分鐘後刪除

輸出

檔案會在我們的伺服器上處理,並於 30 分鐘後刪除。

使用方式

  1. 1

    上傳 HTML 檔案

    加入 .html 或 .htm 檔案,每批最多 20 個,每個最大 95 MB。從瀏覽器儲存的網頁、CMS 匯出檔或手寫的檔案都可以。

  2. 2

    檢查文字設定

    轉換為選 Markdown,格式選簡化,文字編碼選 UTF-8,換行字元選 LF,適合 Git、靜態網站產生器,以及 macOS 或 Linux 的編輯器。

  3. 3

    轉換為 Markdown

    按下 轉換為 Markdown,再用任何文字編輯器開啟 .md,刪除殘留的選單或頁尾。上傳的檔案會在 30 分鐘後刪除。

要將 HTML 轉成 Markdown,請上傳 .html 檔案並按下 轉換為 Markdown:標題會變成 # 開頭的行,連結會變成 文字,清單保留項目符號與編號,簡單的表格會變成以直線分隔的表格。

HTML 轉 Markdown:誰需要、為什麼需要

John Gruber 於 2004 年與 Aaron Swartz 共同發表 Markdown,目的是用純文字撰寫網頁內容,即使尚未轉譯,讀起來也很自然。二十年後,它已成為 GitHub README、Jekyll 和 Hugo 等靜態網站產生器、文件工具、Obsidian 等筆記應用程式,以及許多現代網站內容資料夾的原生格式。

這形成了一股與常見方向相反的穩定需求。離開資料庫型 CMS 的團隊,需要把多年的文章變成 .md 檔案。寫作者把文章剪存到筆記庫。開發者把舊的 HTML 說明區搬進 docs-as-code 儲存庫,讓修改在 pull request 中審查。在這些情況下,HTML 是唯一的副本,手動重寫並不實際。若來源是 Word 文件,同樣的工作請用 DOCX 轉 Markdown。

哪些 HTML 元素有對應的 Markdown 寫法

from ↓ · to →CommonMarkGitHub Flavored Markdown
標題 h1–h6標題 h1–h6 to CommonMark: yes標題 h1–h6 to GitHub Flavored Markdown: yes
連結與圖片連結與圖片 to CommonMark: yes連結與圖片 to GitHub Flavored Markdown: yes
清單與引用區塊清單與引用區塊 to CommonMark: yes清單與引用區塊 to GitHub Flavored Markdown: yes
程式碼與 pre 區塊程式碼與 pre 區塊 to CommonMark: yes程式碼與 pre 區塊 to GitHub Flavored Markdown: yes
簡單表格– 簡單表格 to CommonMark: no簡單表格 to GitHub Flavored Markdown: yes
刪除線– 刪除線 to CommonMark: no刪除線 to GitHub Flavored Markdown: yes
合併的表格儲存格– 合併的表格儲存格 to CommonMark: no– 合併的表格儲存格 to GitHub Flavored Markdown: no
表單、影片、iframe– 表單、影片、iframe to CommonMark: no– 表單、影片、iframe to GitHub Flavored Markdown: no
supported not offered2014 年起制定的 CommonMark 是嚴格的核心規範;2017 年制定的 GitHub Flavored Markdown 加入了表格、刪除線與待辦清單。沒有 Markdown 寫法的內容可保留為原始 HTML,兩者都允許。

HTML 轉 Markdown 轉換結果:會得到什麼

class 名稱、行內樣式、指令碼與版面用的 div 都會被捨棄,因為 Markdown 描述的是意義,而不是外觀。粗體與斜體會變成雙星號與單星號,段落內的換行會被接起來,  這類字元實體會變成 UTF-8 的一般字元。.md 檔案的大小預期只有 HTML 的一小部分:文字保留,標記消失。

迷思Markdown 可以重現任何 HTML 版面。

事實它只涵蓋文字結構;欄位、顏色與定位的方塊在 Markdown 中沒有語法,會遺失或保留為原始 HTML。

迷思轉換後的網頁可以直接發布。

事實選單、Cookie 橫幅與頁尾也會一併轉入;請自行刪減,若網站產生器需要,再加上 front matter。

迷思Markdown 輸出在任何地方的效果都一樣。

事實表格與刪除線需要支援 GitHub Flavored Markdown 的轉譯器;嚴格的 CommonMark 工具會把它們顯示為純文字。

HTML 與 Markdown 格式小知識

HTML

超文字標記語言

HTML 是網頁的標記語言,由 Tim Berners-Lee 在 1990 年代初期提出,現由 WHATWG 以持續更新的標準維護。HTML 檔案用來描述標題、段落、連結、表格、圖片和表單,樣式通常由 CSS 提供。所有瀏覽器都能呈現 HTML,電子郵件範本和儲存的網頁也使用它。單一 HTML 檔案常依賴外部圖片和樣式表,單獨移動後可能會顯示異常。

壓縮方式
–
透明度
–
動畫
–
推出年份
1993 · Tim Berners-Lee; maintained by WHATWG
HTML 轉檔工具

MD

Markdown

Markdown 是 John Gruber 於 2004 年建立的輕量標記語法。它使用純文字符號,例如以 # 表示標題、* 表示強調、- 表示清單,以原始文字顯示時仍易於閱讀,也能乾淨地轉換為 HTML。它是 README 檔、技術文件、Wiki、筆記 App 和許多靜態網站產生器的標準。它有多種方言,例如 CommonMark 和 GitHub Flavored Markdown,在表格等細節上略有差異。任何文字編輯器都能開啟 .md 檔。

壓縮方式
–
透明度
–
動畫
–
推出年份
2004 · John Gruber
MD 轉檔工具

當內容要離開原本呈現它的地方時,就會把 HTML 轉成 Markdown:部落格搬到靜態網站產生器、說明中心移入以 Git 管理的文件庫,或是把文章存進 Obsidian 資料庫,在這些情況下,單純易讀的文字比標記更重要。

HTML 轉 MD 常見問題

存下的網頁可以連同圖片一起轉換嗎?

轉換器會讀取你上傳的 .html 檔案。圖片標籤會變成 Markdown 圖片連結,指向網頁原本使用的路徑或網址,因此放在網路上的圖片仍可正常顯示。瀏覽器「另存新檔」產生的本機圖片資料夾不會隨檔案上傳;把它複製到 .md 旁邊,相對路徑依然吻合。

選單、側邊欄和頁尾會怎麼處理?

檔案中的所有內容都會被轉換,因為工具無法判斷網頁中哪一部分是文章。若想要乾淨的結果,請在 CMS 允許時儲存不含佈景主題的文章,或在轉換後刪除 Markdown 頂端與底部的導覽列內容。

如何把 WordPress 文章搬到 Hugo 或 Jekyll?

WordPress 內建的匯出檔是 XML,不是 HTML,所以請改為轉換每篇文章的 HTML,可從程式碼編輯器複製,或從瀏覽器儲存。接著在每個 .md 最上方加入 front matter,也就是夾在兩行三個破折號之間、記載標題、日期與標籤的區塊。Hugo 和 Jekyll 都會從那裡讀取。

為什麼有些表格轉成 Markdown 後看起來怪怪的?

由 GitHub Flavored Markdown 加入的 Markdown 表格只有一列標題,也沒有合併儲存格。簡單的 HTML 表格可以乾淨地轉換;含有 colspan、rowspan 或巢狀清單的表格沒有對應的 Markdown 寫法,會被攤平。Markdown 允許原始 HTML,因此在版面重要的地方,可以把原本的表格貼回去。

Markdown 適合把網頁內容提供給 AI 或搜尋工具嗎?

通常會。Markdown 保留了重要的結構,包括標題、清單、連結與強調,同時捨棄屬性、指令碼與樣式,所以同一篇文章會變得短得多,也更容易處理。如果完全不想要標記,請使用 HTML 轉 TXT。