轉換器

HTML 轉 Markdown 轉換器

HTML 轉 Markdown 轉換器是一款把上傳的 .html 檔案變成用於提示詞的結構化 Markdown 的轉換器。公開試用接受最大 10 MB 的檔案。

還沒有轉換任何文件

上傳檔案，這裡會顯示乾淨的 Markdown 輸出。

AI 圖片描述高精度 OCR 登入後使用增強功能

先試用檔案，再選擇套餐。

無需帳號：單檔案最大 10 MB、25 頁，每小時 3 次、每天 10 次轉換，可在瀏覽器中預覽並複製。
登入後：每天 20 次免費轉換，結果儲存到你的文件庫。
Lite、Pro 與 Max 包含轉換積分、批次處理、API 存取與歷史記錄。Lite 包含 30 天歷史。

開始使用檢視定價

如何操作

如何把 HTML 轉 Markdown

可以上傳什麼

檔案類型：.html .htm
無需帳號即可試用：單檔案最大 10 MB、25 頁，每小時 3 次、每天 10 次轉換
Lite 支援最大 100 MB 的檔案，Pro 支援 200 MB
Max 沒有單檔案大小上限；轉換量由 credit 限制

HTML 轉 Markdown 轉換器：把 HTML 頁面轉成 Markdown 視窗

為什麼使用

為什麼使用 HTML 轉 Markdown

語義化標題

把有意義的 HTML 標題結構轉成 Markdown 大綱，並在原始碼檢視裡複核得到的層級。

連結與列表

把受支援的連結文字和列表結構帶進 Markdown，再在你複用輸出的上下文裡核對目標。

儲存的快照輸入

處理你已經擁有的 HTML，而不去抓取一個自原始匯出以來可能已變動的線上頁面。

程式碼與表格複核

在目標渲染器裡檢查圍欄程式碼和簡單表格，然後再發布從 HTML 遷移來的文件。

CSS 不進入文字

聚焦文件內容，而不是復現定位、動畫或某個互動式網站主題。

從 HTML 自動化

對受支援的檔案或內嵌文字輸入使用 HTML API 路徑，並在整合裡處理非同步完成。

問題所在

為什麼 HTML 檔案仍帶著外殼

樣板噪聲

當儲存的檔案包含整頁時，導航、頁尾和廣告會圍住你真正想要的內容。

巢狀標記

深層巢狀的標籤和內嵌樣式會阻擋真實的文件結構。

標題不一致

HTML 裡的標題層級常被誤用；乾淨的 Markdown 會在標籤存在處正規化層級。

轉換 HTML 為 Markdown：複製貼上後的錯亂文字與乾淨的 Markdown 結構對比

保留什麼

這款 HTML 轉 Markdown 轉換器保留什麼

上傳檔案，不抓取: 這個工具轉換上傳的 .html 或 .htm 檔案。要按 URL 轉換線上網頁，請用 /url-to-markdown 的 URL 轉 Markdown 轉換器。Source: HTML Living Standard
標題與表格: HTML 標題標籤（h1–h6）對應為 Markdown 標題，表格元素變成 Markdown 管線表格。Source: CommonMark Spec
內嵌指令碼與樣式: 內嵌 script 和 style 塊會從輸出裡移除；只保留可見的文件內容。Source: HTML Living Standard
儲存檔案裡的樣板內容: 目前轉換器保留頁面文字，其中可能包含隨檔案一起儲存的導航、頁尾和其它樣板內容。使用前請複核 Markdown。Source: product pipeline

示例：markitdown.ai API 文件的 Quickstart 頁· https://markitdown.ai/docs/quickstart

[Home](/) Getting started [Introduction](/docs)[Authentication](/docs/authentication)[Quickstart](/docs/quickstart) Core [Convert](/docs/convert)[Conversions](/docs/conversions)[Batches](/docs/batches)[Conversion Files](/docs/files)[Markdown Render](/docs/render) Developer [API keys](/docs/api-keys)[Webhooks](/docs/webhooks) Reference [URL fetcher](/docs/fetcher)[Errors & limits](/docs/errors-and-limits) API reference [All endpoints](/docs/api)[Error codes](/docs/errors) Quickstart Getting started # Quickstart Convert your first document to Markdown with the v1 API: one POST /v1/convert call, then read or poll the result.

使用場景

HTML 轉 Markdown 的真實工作流

CMS 匯出

為 Markdown 目標環境準備匯出的文章，檢查連結、媒體引用和標題結構。

文件遷移

在遷移一批 HTML 指南前，先在新渲染器裡複核程式碼示例和表格。

歸檔快照

處理已知的已儲存頁面，而不是依賴某個線上 URL 今天恰好返回什麼。

文字攝取

轉換你自己授權的工作流所收集的 HTML，並在建立索引前複核周邊的導航。

HTML 表格轉 Markdown：把一個 Markdown 表格接入 RAG 索引、提示詞與筆記

API

HTML 轉 Markdown API

用 POST /v1/convert/html，帶上 x-api-key 請求標頭和受支援的原始檔。已完成的請求可以內嵌返回輸出；HTTP 202 表示轉換仍在進行。讀取 Location 回應標頭並在存取檔案輸出前輪詢它。一次 multipart 請求最多接受 100 個檔案；訂閱額度和總請求限額同樣適用。把 API 金鑰放在你的伺服器環境裡。API 存取需要 Lite、Pro 或 Max 訂閱。

閱讀 API 指南

curl -i "https://api.markitdown.ai/v1/convert/html" \  -H "x-api-key: $MARKITDOWN_API_KEY" \  -F "file=@source.html"# If HTTP 202, GET the Location URL with the same API key.

指南

HTML 檔案與 URL 的區別

HTML 轉 Markdown 從你已經擁有的 HTML 開始。URL 轉 Markdown 從一個網路地址開始，先抓取公開頁面再轉換。當你需要處理一個已知的快照、一份模板匯出或你自己的系統已收集的內容時，用儲存好的 HTML 檔案。當公開頁面就是你現在想檢索的來源時，用 URL 工具。HTML 轉換器不執行指令碼去填補缺失的內容，所以一個儲存下來的應用外殼可能只包含你在瀏覽器裡看到的文章的一小部分。在排查 Markdown 輸出之前，先檢查你提交的來源，確認你需要的文字確實存在。

檢查輸出結果

HTML 轉 Markdown 可以把標題、段落、列表、連結、程式碼和簡單的表格表示為緊湊的文字形式。CSS 定位和互動控制項在普通 Markdown 裡沒有直接對應物。與用帶樣式的通用容器拼成的頁面相比，一個有意義地使用標題元素的頁面，會給轉換器更清晰的大綱。在 Markdown 原始碼裡複核匯出的標題層級和一段有代表性的巢狀列表。對錶格，確認表頭仍然描述它下面的值。目標是可讀地呈現文件內容，而不是重建瀏覽器的版式、游標停留行為或視覺主題。

導航與連結

HTML 轉 Markdown 可能把導航、頁尾文字和其它內容與正文一起保留下來。不要假設轉換器已辨識出正文，或已移除每一條廣告。在把匯出內容加入檢索索引前，檢查開頭和結尾有沒有重複的選單。一份儲存下來的 HTML 檔案還可能包含相對連結，其含義取決於原站的位置。在你發布 Markdown 的上下文裡核對這些目標，並在自己的工作流裡提供有意義的來源引用。轉換連結語法並不證明目標仍然存在，而本機檔案也不會自動提供原網站的基址。

CMS 遷移

在匯出整個 CMS 之前，先用一篇有代表性的文章測試 HTML 轉 Markdown。選擇一篇包含表格、程式碼、圖片、連結和巢狀標題的文章，這樣你就能早發現重要差異。在目標渲染器裡對照結果，因為不同的 Markdown 引擎對擴充功能的支援可能不同。把原始 HTML 匯出留作稽核副本，並記錄它屬於哪篇文章。在遷移流程裡決定如何處理重複的導航和媒體資源；這個轉換器不會替你發布內容或搬移網站的檔案。一份經過複核的 Markdown 匯出是這次遷移的可攜起點，而不是已完成的網站遷移。

檔案保留了哪些內容

這個工具轉換你已經擁有的檔案。它不抓取網路。檔案裡的導航、頁尾和其它樣板內容仍可能出現在 Markdown 裡——嵌入前請先複核。要按 URL 轉換線上網頁，請用 URL 轉 Markdown 轉換器。

HTML 標題標籤（h1–h6）對應為 Markdown 標題。
HTML 表格變成 Markdown 管線表格。
內嵌 script 和 style 塊會被移除；只保留可見的文件內容。