Giới thiệu & Mục đích sử dụng
Người làm nội dung, kỹ sư viết tài liệu kỹ thuật hoặc lập trình viên sử dụng trợ lý AI thường soạn bài ở định dạng Markdown (#, **đậm**, bảng |---|, khối mã) rồi cần xuất sang mã HTML sạch sẽ để nhúng vào hệ quản trị nội dung (Ghost CMS, WordPress, trang web tĩnh, mẫu email). Ngược lại, khi copy bài viết từ trang web hoặc trình soạn thảo văn phòng cũ, mã HTML thường chứa hàng loạt thẻ <span style="..."> rườm rà cần chuyển ngược về Markdown gọn gàng.
Công cụ Đổi Markdown Sang HTML trên N1A hỗ trợ đầy đủ cú pháp CommonMark và GitHub Flavored Markdown (GFM) như bảng căn lề, danh sách việc cần làm (Task List), trích dẫn và khối mã có nhãn ngôn ngữ, đồng thời tích hợp cơ chế lọc an toàn chống XSS trước khi hiển thị bản xem trước trực tiếp.
Cách dùng từng bước
-
Chọn chiều chuyển đổi: Markdown → HTML hoặc HTML → MarkdownChuyển đổi tức thì ngay trên thanh phân đoạn ở đầu công cụ tùy theo nguồn tài liệu bạn đang có.
-
Dán nội dung Markdown hoặc mã HTML vào ô soạn thảoHỗ trợ tiêu đề H1–H6, bảng GFM có căn trái/giữa/phải, khối mã fenced code ```, checklist, ảnh và liên kết.
-
Bật hoặc tắt tự động gắn thuộc tính id cho HeadingKhi bật, mỗi tiêu đề tiếng Việt tự sinh id không dấu chuẩn SEO (ví dụ id="danh-sach-kiem-tra") để làm liên kết neo mục lục.
-
Xem trước kết quả hoặc sao chép mã nguồn sạchChuyển giữa tab 'Xem trước hiển thị' và 'Mã nguồn HTML', sau đó sao chép 1 chạm hoặc tải về tệp .html / .md.
Công thức & Phương pháp tính
Trình biên dịch chạy thuần trên trình duyệt tuân thủ 2 chuẩn cốt lõi là CommonMark Spec 0.31 và quy chuẩn làm sạch mã OWASP XSS Prevention:
- Phân tích cấp độ khối (Block Parsing): Nhận diện lần lượt khối mã rào chắn (
```lang) để bảo vệ nội dung code không bị hiểu nhầm thành cú pháp Markdown, tiếp theo là tiêu đềH1–H6, đường kẻ ngang, bảng GFM (hỗ trợ căn lề:---,:---:,---:), khối trích dẫn>và danh sách có/không thứ tự. - Tạo ID mục lục tiếng Việt không dấu: Tự động chuẩn hóa chữ
đ/Đvà dấu thanh điệu của tiêu đề để sinh thuộc tínhidhợp lệ cho liên kết nhảy mục (anchor links). - Lọc an toàn XSS hai lớp (Defense-in-Depth Sanitization): Mọi đầu ra HTML đều được loại bỏ thẻ nguy hiểm (
<script>,<iframe>,<object>,<embed>), xóa các thuộc tính sự kiện nhưonerror,onclick,onloadvà vô hiệu hóa đường dẫnjavascript:hoặcvbscript:trước khi dựng DOM xem trước.
| Cú pháp Markdown | Thẻ HTML ngữ nghĩa sinh ra | Ghi chú chuẩn hóa |
|---|---|---|
## Mục tiêu SEO | <h2 id="muc-tieu-seo">Mục tiêu SEO</h2> | Tự sinh neo mục lục tiếng Việt |
**chữ đậm** / *nghiêng* | <strong>chữ đậm</strong> / <em>nghiêng</em> | Đúng ngữ nghĩa HTML5 thay cho thẻ b/i cũ |
| Cột | Giá trị | | <table><thead>...<tbody>... | Chuẩn GFM, giữ căn lề theo dấu hai chấm |
- [x] Hoàn thành | <ul><li><input type="checkbox" checked disabled>... | Tương thích checklist GitHub/Notion |
Ví dụ minh họa
Ví dụ 1 — Xuất bảng báo cáo và tiêu đề sang HTML sạch: Nhập # Tiêu đề chính cùng bảng GFM căn phải | Dòng 1 | 100 |, công cụ sinh ra <h1 id="tieu-de-chinh">Tiêu đề chính</h1> và bảng <table> chuẩn với ô số <td align="right">100</td>, không chứa bất kỳ style="font-family:..." rác nào như khi copy từ Word.
Ví dụ 2 — Chặn mã độc khi người dùng vô tình dán đoạn HTML có chứa script: Nếu đầu vào chứa <img src="x" onerror="evil()"><a href="javascript:alert(2)">Bấm</a>, bộ lọc sẽ tước bỏ thuộc tính onerror và đổi liên kết nguy hiểm thành # trước khi hiển thị bản xem trước.
Lưu ý quan trọng
HTML sinh ra từ công cụ giữ dạng thẻ ngữ nghĩa thuần túy để dễ kế thừa CSS của website đích (như theme báo chí N1A Press, Ghost hay WordPress). Với các hệ thống CMS yêu cầu chèn mã CSS tùy chỉnh hoặc thẻ <iframe> nhúng video YouTube, bạn nên dán mã HTML sạch này trước rồi mới dùng khối Embed chuyên biệt của CMS đó.
Câu hỏi thường gặp
Markdown là gì và tại sao dân SEO, lập trình viên chuộng hơn viết trực tiếp bằng Word?
Markdown là ngôn ngữ đánh dấu văn bản thuần gọn nhẹ (dùng #, **, -, |) giúp tách biệt nội dung khỏi định dạng trình bày rườm rà. Khi chuyển từ Markdown sang HTML, mã nguồn rất sạch, nhẹ và không làm hỏng giao diện website như khi copy thẳng từ Microsoft Word.
Công cụ có hỗ trợ tạo bảng biểu (Table) và danh sách Task List không?
Có. Công cụ hỗ trợ chuẩn bảng GitHub Flavored Markdown (bao gồm căn trái, giữa, phải theo ký hiệu :---: và ---:) cũng như danh sách checkbox - [ ] và - [x].
Mã HTML sinh ra có an toàn khi dán nội dung từ nguồn bên ngoài không?
Có. Hệ thống tích hợp bộ lọc bảo mật XSS giúp loại bỏ các thẻ thực thi nguy hiểm như <script>, <iframe>, sự kiện onerror/onclick và liên kết javascript:.
Tôi có thể chuyển ngược từ trang HTML có sẵn sang Markdown để chỉnh sửa lại không?
Có. Bạn chỉ cần bấm nút chuyển chiều sang 'HTML → Markdown' ở đầu công cụ, dán đoạn HTML cần chuyển để nhận lại văn bản Markdown sạch sẽ.
Thuộc tính id tự sinh ở thẻ H1, H2, H3 dùng để làm gì?
Các id tiếng Việt không dấu (ví dụ #muc-tieu-seo) cho phép bạn tạo mục lục bài viết (Table of Contents) giúp độc giả bấm nhảy thẳng tới từng phần nội dung và hỗ trợ Google hiển thị liên kết phần trên kết quả tìm kiếm.
Nội dung bài viết nháp chưa xuất bản có bị lưu trên máy chủ N1A không?
Không. Trình biên dịch Markdown và bản xem trước đều hoạt động 100% cục bộ trên trình duyệt của bạn.
Căn cứ pháp lý & Nguồn tham khảo
- CommonMark Specification (Version 0.31.2) (Đặc tả chuẩn hóa chính thức cú pháp Markdown hiện đại)
- GitHub Flavored Markdown (GFM) Spec (Mở rộng bảng biểu, gạch ngang chữ và Task List)
- OWASP Cross Site Scripting Prevention Cheat Sheet (Nguyên tắc làm sạch HTML ngăn chặn XSS)