Markdown sang HTML API

Chuyển Markdown chuẩn GitHub sang HTML, hỗ trợ bảng và gạch ngang. Kết quả được lọc sẵn script và event handler để chống XSS.

GETPOSThttps://apibox.io.vn/v1/markdown-to-html
Nội dung & HTML▶ Dùng thử online

Gửi Markdown qua trường markdown (JSON, form hoặc query string) hoặc dưới dạng body văn bản thô, API trả về HTML trong trường html. API dùng bộ parser marked với GitHub-flavored Markdown: hỗ trợ bảng, gạch ngang, tự nhận link và khối code fenced. Đặt breaks=true để mỗi lần xuống dòng thành thẻ <br>.

Vì Markdown có thể chứa HTML thô, kết quả mặc định được làm sạch: loại bỏ các thẻ script, style, iframe, object, embed, form..., các thuộc tính on*, style và URL dạng javascript: / vbscript: / data:text. Chỉ nên đặt sanitize=false khi nội dung Markdown đến từ nguồn tin cậy.

Body request tối đa 1 MB, trường markdown tối đa 2.000.000 ký tự.

Tham số

TênVị tríKiểuBắt buộcMặc định
markdownbody|querystringcóNội dung Markdown (tối đa 2.000.000 ký tự). Có thể gửi dưới dạng body văn bản thô.
breaksbody|querybooleankhôngfalseChuyển mỗi lần xuống dòng thành <br>.
sanitizebody|querybooleankhôngtrueLoại bỏ script, event handler, thuộc tính style và URL nguy hiểm khỏi kết quả.

Ví dụ

curl -X POST "https://apibox.io.vn/v1/markdown-to-html" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Release notes\n\nVersion **2.0** adds [dark mode](https://example.com/dark).\n\n- Faster builds\n- ~~Old API~~ removed\n\n| Plan | Price |\n| --- | --- |\n| Free | $0 |"}'

Kết quả trả về

{
  "html": "<h1>Release notes</h1>\n<p>Version <strong>2.0</strong> adds <a href=\"https://example.com/dark\">dark mode</a>.</p>\n<ul>\n<li>Faster builds</li>\n<li><del>Old API</del> removed</li>\n</ul>\n<table>\n<thead>\n<tr>\n<th>Plan</th>\n<th>Price</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Free</td>\n<td>$0</td>\n</tr>\n</tbody></table>\n"
}

Ứng dụng

  • Hiển thị file README hoặc tài liệu Markdown trên website
  • Hiển thị bình luận người dùng viết bằng Markdown mà không lo XSS
  • Tạo nội dung email HTML, newsletter từ bản nháp Markdown
  • Xem trước Markdown trong CMS hoặc quy trình build static site

Hỏi đáp

HTML trả về có an toàn để chèn vào trang không?

Mặc định là có với các kiểu tấn công phổ biến: script, iframe, form, event handler, thuộc tính style và link javascript: đều bị loại bỏ. Chỉ tắt bằng sanitize=false với dữ liệu tin cậy.

Có hỗ trợ bảng Markdown kiểu GitHub không?

Có. GFM được bật sẵn nên bảng dạng |, ~~gạch ngang~~ và link tự động đều được render.

Làm sao giữ nguyên các lần xuống dòng đơn?

Đặt breaks=true. Mỗi lần xuống dòng trong đoạn văn sẽ thành thẻ <br>, giống bình luận trên GitHub.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →