如何將HTML轉換為Markdown
- 貼上一段HTML或上傳支援的
.html檔案。 - 轉換來源，並檢查在Markdown中哪些語意元素仍然有意義。
- 轉換並檢查連結、圖片、嵌套清單、表格和程式碼圍欄（code fences）。
- 複製Markdown或下載
.md檔案。
轉換器保留哪些內容？
| 來源內容 | 推薦的輸出行為 | 轉換說明 |
|---|---|---|
| 標題 | 將 <h1>–<h6> 映射為 Markdown 標題 | |
| 段落和強調 | 轉換段落、加粗和斜體 | |
| 清單 | 轉換有序、無序和嵌套清單 | |
| 連結 | 保留文字和解析後的 URL | |
| 圖片 | 保留來源和替代文字（alt） | |
| 程式碼 | 使用行內程式碼和圍欄程式碼區塊 | |
| 表格 | 將相容的表格轉換為 GFM | |
| 區塊引用 | 轉換語意區塊引用 |
轉換過程中可能會有哪些變化？
指令碼、樣式和表單
可執行和互動式元素在普通Markdown中沒有對應語法，可能會被省略或簡化為文字。
複雜表格
跨行（rowspans）、跨列（colspans）、嵌套表格以及複雜的儲存格內容可能需要原始HTML或扁平化處理。
相對URL
貼上的片段可能不包含頁面的基本URL，因此相對連結和圖片路徑不一定總能解析成功。
版面配置容器
div、網格（grid）和彈性盒（flexbox）配置並不蘊含語意閱讀順序。
隱藏和樣板內容
轉換器需要有針對隱藏元素、導覽和視覺上折疊內容的明確處理策略。
HTML轉Markdown的常見用途
遷移Web文件
將語意化的HTML移入基於Markdown的文件系統中。
清理複製的富文本
在進行版本控制或發布之前，將編輯器產生的HTML轉換為更簡單的格式。
準備程式碼範例
保留程式碼區塊和標題，而無需引入完整的頁面樣式表。
建立文字優先的AI上下文
移除指令碼和樣式，同時保留仍需審查的信息結構。
HTML轉Markdown範例
<h2>Setup</h2>
<p>Read the <a href="/guide">guide</a>.</p>
<ul><li>Install</li><li>Test</li></ul>## Setup
Read the [guide](/guide).
- Install
- Test獲得更整潔Markdown輸出的技巧
- 使用語意化HTML 相比通用的版面配置容器，標題、清單和表格的轉換更為可靠。
- 在需要時提供基本URL 如果結果需要在原始頁面之外使用，相對連結需要上下文資訊。
- 選擇輸出方言 GFM支援普通CommonMark未定義的表格和任務清單。
- 檢查程式碼圍欄 確認檢測到的程式語言以及任何嵌入的反引號。
- 決定原始HTML備用方案 保留不支援的HTML雖然可以保留資訊，但會降低可移植性。
常見問題
<script> 和 <style> 元素會被移除嗎？
指令碼和樣式不是有用的Markdown內容，在转换結果中不應依賴它們。 在重新使用輸出之前，請檢查貼上的HTML。
HTML表格會被轉換為Markdown表格嗎？
相容的矩形表格可以轉換為GFM表格。 帶有 rowspan、colspan、嵌套區塊或多個表頭列的表格需要有記錄的備用方案。
程式碼區塊 and 行內程式碼會保留嗎？
它們可以從 <pre> 和 <code> 進行映射。
連結和圖片會怎麼樣？
有效的連結文字和目標地址可能會被保留。 相對連結和圖片路徑仍然依賴於上下文，因爲上傳的片段沒有保證的基本URL。
不支援的HTML標籤會被移除還是保留？
僅用於展示的包裝標籤可能會被簡化，同時保留可讀文字。 當自訂元素帶有意義時，請將輸出與原始檔案進行對比。
轉換器輸出的是CommonMark還是GFM？
預期的輸出是GitHub風格的Markdown（GFM）。 表格、刪除線和任務清單依賴於GFM擴充功能。
我可以貼上整個HTML文件嗎？
可以。 您可以貼上一個片段或上傳 .html 或 .htm 檔案，然後檢視產生的Markdown。
此頁面可以轉換在線網站的URL嗎？
不可以。 此頁面只接受貼上的HTML或上傳的HTML檔案，不會抓取在線網站URL。
將Markdown轉換回 PDF
已經有Markdown檔案了嗎？使用Markdown轉PDF轉換器來建立可分享的PDF。