如何在瀏覽器裡把 Markdown 轉成 HTML
把 README、變更說明和知識庫草稿一鍵變成可粘貼進 CMS 的 HTML 片段——本地處理,適合不方便跑本地構建環境的電腦。

為什麼有用
團隊在 Git 裡寫 Markdown,但企業 CMS 只收淨化後的 HTML;支持人員在工單裡貼 fenced code,後臺卻過濾失敗;市場同學先用 Markdown 飛快起草,再交給設計師填進郵件模板。本地轉換可以避免把保密草案上傳到來歷不明的「在線 MD 轉 HTML」。
三類場景
寫完 Markdown,轉成片段後嵌入 Astro/React 局部組件。
直接可用的 HTML
將排查步驟轉成 <ol> + <pre>,再寫入知識庫 HTML。
歸檔更清晰
在受限編輯器外預覽標題層級與錨點行為。
少踩所見即所得坑
操作步驟
打開 Markdown 轉 HTML。
按常用語法撰寫
標題、列表、鏈接、圍欄代碼、引用等;若 CMS 白名單有限,避免使用不被允許的擴展。
選擇渲染選項
若目標平臺兼容 GitHub Flavored Markdown,可開啟表格、刪除線等擴展。
檢查預覽
留意列表嵌套、裸鏈自動識別等細節是否符合預期。
複製 HTML 片段
在無 Node 環境的電腦上也能快速交付。
Input
## Rollout checklist
1. Enable **feature flag** `payments.v2`
2. Monitor `/health/payments` for 15 minutes
3. Run: kubectl rollout status deploy/payments-apiOutput
<h2>Rollout checklist</h2>
<ol>
<li>Enable <strong>feature flag</strong> <code>payments.v2</code></li>
<li>Monitor <code>/health/payments</code> for 15 minutes</li>
<li>Run: kubectl rollout status deploy/payments-api</li>
</ol>實用技巧
常見誤區
常見陷阱
原始 HTML 直通
若擴展允許裸 HTML,可能與淨化策略衝突——先在沙箱 CMS 裡驗證。
常見陷阱
相對鏈接不變
遷移域名後相對路徑仍指向舊站——上線前全局檢查。
常見陷阱
縮進代碼塊
縮進式代碼塊與圍欄代碼塊規則不同,出問題先核對 Markdown 規範。
不適合的場景
- 完整靜態站點流水線:Eleventy、Astro 等有目錄級能力。
- 郵件 HTML:需要內聯樣式與表格佈局,另有專用工具鏈。
- 精細排版 PDF:LaTeX 等更合適。
常見問題
會調用後端接口嗎?
解析在瀏覽器本地執行,適合含保密條款的草案。
能否 HTML 反向轉 Markdown?
本教程側重 MD→HTML;逆向清理建議用專門工具處理遺留 CMS 導出。
支持哪種方言?
按頁面可選開關對齊 GitHub Flavored 等行為;實驗性擴展請逐項驗證。