Đánh dấu xuống Trình chuyển đổi HTML
Chuyển đổi văn bản Markdown thành mã HTML sẵn sàng sản xuất với sự hỗ trợ xem trước trực tiếp.
Chuyển đổi văn bản Markdown thành mã HTML sẵn sàng sản xuất với sự hỗ trợ xem trước trực tiếp.
Markdown là một ngôn ngữ đánh dấu nhẹ do John Gruber tạo ra vào năm 2004 để cho phép người viết tạo HTML có cấu trúc bằng cách sử dụng các quy ước văn bản thuần túy: ký tự băm cho tiêu đề, dấu hoa thị để nhấn mạnh, dấu gạch ngang cho danh sách, khối thụt lề cho mã. Định dạng này đã trở thành mặc định cho các tệp README, tài liệu kỹ thuật, bản nháp blog, trình tạo trang tĩnh và bất kỳ ngữ cảnh nào mà văn bản có thể đọc được dưới dạng văn bản thuần túy và dưới dạng đầu ra được hiển thị. Chuyển đổi Markdown sang HTML là bước kết xuất biến nguồn thành trang web.
Trình chuyển đổi này sử dụng thư viện được đánh dấu, trình kết xuất Markdown được áp dụng rộng rãi nhất trong JavaScript. Marked hỗ trợ CommonMark và GitHub Flavored Markdown (GFM), có nghĩa là các bảng, khối mã có rào chắn, danh sách nhiệm vụ, gạch ngang và tự động liên kết đều hoạt động chính xác ngoài các tính năng Markdown tiêu chuẩn.
Đầu ra là HTML đơn giản — các thẻ ngữ nghĩa cho tiêu đề, đoạn văn, danh sách, liên kết và hình ảnh, cùng với các móc nối lớp cho các khối mã nơi các công cụ đánh dấu cú pháp mong đợi chúng. Đầu ra dán rõ ràng vào bất kỳ CMS nào, nhúng vào trình tạo trang tĩnh hoặc hoạt động dưới dạng .html độc lập. Không có CSS hoặc JavaScript nào được thêm vào; việc tạo kiểu, kết quả được để lại cho bối cảnh phía dưới của bạn.
Markdown là định dạng mà người viết và nhà phát triển ưa thích; HTML là định dạng mà trình duyệt hiển thị. Hầu hết các trình tạo trang tĩnh và nền tảng CMS đều chuyển đổi Markdown thành HTML ở hậu trường, nhưng đôi khi bạn cần chuyển đổi như một bước độc lập — dán vào CMS không hỗ trợ Markdown, tạo HTML cho email, tạo bản xem trước nhanh hoặc trích xuất kết quả được hiển thị để xử lý thêm.
HTML cũng là định dạng chuẩn cho bất kỳ nội dung nào cuối cùng sẽ được hiển thị trong trình duyệt. Các bản tin email được tạo từ bản nháp Markdown, các trang tài liệu được nhúng trong các ứng dụng HTML lớn hơn và các bài đăng trên blog được dán vào các trình chỉnh sửa mong đợi HTML đều được hưởng lợi từ một chuyển đổi rõ ràng.
Dán Markdown, lấy HTML.
Marked sử dụng kiến trúc hai lượt. Từ vựng mã hóa thông tin đầu vào thành mã thông báo cấp khối (tiêu đề, đoạn văn, danh sách, khối mã) và mã thông báo nội tuyến (nhấn mạnh, liên kết, hình ảnh). Trình phân tích cú pháp đi theo luồng mã thông báo và phát ra HTML, áp dụng các móc kết xuất cho từng loại mã thông báo.
Các tiện ích mở rộng Markdown có hương vị của GitHub được bật theo mặc định: bảng (sử dụng cú pháp ống), khối mã có rào chắn (ba dấu phẩy ngược với gợi ý ngôn ngữ), danh sách tác vụ (- [] và - [x]), gạch ngang (sử dụng dấu ngã kép) và tự động liên kết URL. Các khối mã phát ra mã được bao bọc sẵn với lớp ngôn ngữ tùy chọn để làm nổi bật cú pháp xuôi dòng.
Việc vệ sinh đầu ra được để lại cho người tiêu dùng ở hạ nguồn. Marked phát ra bất cứ thứ gì đầu vào tạo ra, bao gồm cả HTML thô được nhúng trong Markdown. Nếu bạn chấp nhận đầu vào không đáng tin cậy, hãy chạy đầu ra thông qua DOMPurify hoặc trình khử trùng HTML tương tự trước khi hiển thị trong trình duyệt.