Chuyển đổi miễn phí

Đá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.

Về công cụ này

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.

Tại sao chuyển đổi Markdown sang HTML

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.

Cách sử dụng

Dán Markdown, lấy HTML.

  1. Thêm đánh dấu của bạn: Dán văn bản Markdown vào vùng nhập hoặc thả tệp .md. Cả cú pháp Markdown tiêu chuẩn và cú pháp Markdown có hương vị GitHub đều hoạt động.
  2. Chuyển đổi: Marked phân tích cú pháp Markdown thành AST và phát ra HTML. Các phần tử nội tuyến tiêu chuẩn (nhấn mạnh, mạnh mẽ, liên kết, mã, hình ảnh), phần tử khối (tiêu đề, đoạn văn, danh sách, trích dẫn khối) và phần mở rộng GFM (bảng, mã có rào chắn, danh sách tác vụ, liên kết tự động) đều hiển thị chính xác.
  3. Xem trước: Kiểm tra HTML được hiển thị trong bảng xem trước. Xác nhận các khối mã, bảng và các thành phần phức tạp khác xuất hiện như mong đợi.
  4. Sao chép hoặc tải xuống: Sao chép HTML vào khay nhớ tạm để dán vào CMS hoặc lưu dưới dạng .html để sử dụng độc lập. Đầu ra là HTML5 ngữ nghĩa không có kiểu nội tuyến.

Các trường hợp sử dụng phổ biến

Chi tiết kỹ thuật

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.

Thực tiễn tốt nhất

Câu hỏi thường gặp

Việc chuyển đổi MARKDOWN sang HTML có làm thay đổi nội dung không?
Nội dung được bảo quản chính xác nhất có thể. Tuy nhiên, một số tính năng dành riêng cho định dạng có thể không có tính năng tương đương trực tiếp, do đó có thể xảy ra những khác biệt nhỏ về định dạng.
Định dạng HTML được sử dụng để làm gì?
HTML (Ngôn ngữ đánh dấu siêu văn bản) chủ yếu được sử dụng cho các trang web và nội dung web.
Có bất kỳ hạn chế nào cần lưu ý không?
Các tập tin lên tới 50 MB được hỗ trợ. Các tệp rất lớn hoặc phức tạp có thể mất nhiều thời gian hơn để xử lý. Tất cả chuyển đổi diễn ra trong trình duyệt của bạn, vì vậy tốc độ xử lý phụ thuộc vào thiết bị của bạn.
Việc chuyển đổi này có an toàn và riêng tư không?
Đúng. Tất cả quá trình xử lý diễn ra cục bộ trong trình duyệt của bạn. Dữ liệu của bạn không bao giờ rời khỏi thiết bị của bạn — không cần tải lên máy chủ, không xử lý đám mây, không thu thập dữ liệu.
Biểu tượng cảm xúc có được hỗ trợ không?
Biểu tượng cảm xúc Unicode truyền trực tiếp (nhập biểu tượng cảm xúc trái tim sẽ hiển thị hình trái tim ở đầu ra). Kiểu GitHub :emoji: mã ngắn không được chuyển đổi theo mặc định; thêm phần mở rộng nếu bạn cần điều đó.
Markdown của tôi có được tải lên máy chủ không?
Không. Đã đánh dấu chạy trong trình duyệt của bạn; quá trình chuyển đổi diễn ra hoàn toàn trên thiết bị của bạn.
Tôi có thể thêm kiểu tùy chỉnh vào HTML không?
Có, sau khi chuyển đổi. Đầu ra là HTML ngữ nghĩa đơn giản; áp dụng CSS của riêng bạn để tạo kiểu cho tiêu đề, khối mã, bảng và các thành phần khác.
Nó có hỗ trợ chú thích cuối trang không?
CommonMark tiêu chuẩn không chỉ định cú pháp chú thích cuối trang. Một số tiện ích mở rộng Markdown hỗ trợ cú pháp chú thích cuối trang [^1]; bộ chuyển đổi này tuân theo GFM, không bao gồm chú thích cuối trang.