功能介紹
Markdown 轉 HTML 工具把 Markdown 文字轉換成 HTML 標記,可以貼到 CMS、電子郵件範本、靜態頁面,或任何只接受 HTML、不支援 Markdown 的地方。適合把 README 發布到網站、把筆記搬進部落格編輯器,或查看一段 Markdown 究竟會產生哪些標籤。
輸出和主流 Markdown 轉譯器產生的 HTML 一致:<h1> 到 <h6> 標題、<p> 段落、<ul> 和 <ol> 清單、帶 language- class 的 <pre><code> 程式碼區塊(方便語法上色),以及 GitHub 風格表格對應的 <table>。
使用方法
- 輸入或貼上 Markdown、上傳
.md檔案,或按「範例」。 - 依需求選擇選項:GitHub 風格 Markdown、單一換行轉
<br>、用於錨點連結的標題 ID、針對不可信任內容的安全過濾,以及輸出完整 HTML 頁面而非片段。 - 複製 HTML,或下載為
.html檔案。
結果會隨輸入即時更新。要把結果貼進現有頁面時關閉完整頁面選項,需要獨立檔案時再開啟。
範例
這段 Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
會轉換成以下 HTML:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
小提示
- 預設情況下 Markdown 裡的原始 HTML 會原樣保留,這也是大多數轉譯器的做法。只要 Markdown 是別人寫的,就開啟安全過濾。
- 開啟標題錨點後,可以用
page.html#install這樣的網址連到某個小節,也能根據標題產生目錄。 - 程式碼區塊的語言會保留為 class,Prism、highlight.js 等上色函式庫不用額外設定就能辨識。
- 想並排預覽轉譯效果,可以用 Markdown 預覽工具;反向轉換可以用 HTML 轉 Markdown 工具。
常見問題
› 支援哪些 Markdown 語法?
支援全部 CommonMark 語法,包括標題、強調、連結、圖片、清單、引用、程式碼和分隔線。開啟 GitHub 風格 Markdown 後,還支援帶對齊的表格、任務清單、刪除線和裸網址自動連結。
› 安全過濾選項有什麼用?
它會把 Markdown 裡的原始 HTML 跳脫成文字顯示,而不是變成標籤,並移除使用 javascript、vbscript 等不安全協定的連結和圖片。Markdown 來自不可信任的使用者時(例如留言、論壇文章)應該開啟。
› 標題錨點 ID 是怎麼產生的?
和 GitHub 的規則相同。標題文字轉小寫、移除標點、空格換成連字號,所以 Getting Started 的 id 是 getting-started。重複的標題會加上 -1、-2 等後綴,確保每個錨點唯一。
› 完整 HTML 頁面選項有什麼用?
它會把結果包成完整頁面,帶有 doctype、UTF-8 字元集、viewport 標籤、取自第一個一級標題的 title,以及一小段易讀的樣式。存成 .html 檔後,在任何瀏覽器都能直接開啟。
› 我的 Markdown 會被上傳嗎?
不會。轉換在瀏覽器中以 marked 函式庫完成,不會上傳到伺服器。