HTML hay Markdown? Trước khi xuất định dạng bằng Claude Code, hãy dành 30 giây để suy nghĩ về những điều này

Các kỹ sư Claude Code đề xuất thay thế Markdown bằng HTML làm định dạng mặc định cho đầu ra của AI, gây ra tranh luận trái chiều, có các nhà bình luận đề xuất người dùng nên dành 30 giây để đánh giá những vấn đề này trước khi yêu cầu AI tạo ra định dạng.

Các kỹ sư Claude Code đề xuất HTML thay thế Markdown

Trong bối cảnh các đại lý AI (AI Agents) ngày càng phổ biến, định dạng Markdown đã trở thành tiêu chuẩn mặc định để giao tiếp giữa AI và người dùng.

Nhưng gần đây, Thariq Shihipar, kỹ sư Claude Code, đã đăng bài chỉ ra rằng, khi khả năng của AI đại lý được nâng cao đáng kể, Markdown dần trở thành một giới hạn, các tệp Markdown dài quá 100 dòng khó đọc, và còn gặp nhiều bất tiện trong chia sẻ và trình bày trực quan. Nếu chuyển định dạng đầu ra của Claude Code sang HTML, sẽ mang lại lợi thế rõ rệt.

Ông nhấn mạnh rằng, HTML có mật độ thông tin cực cao, có thể trình bày dữ liệu thiết kế qua CSS, vẽ minh họa bằng SVG, thậm chí kết hợp JavaScript để thực hiện chức năng tương tác hai chiều.

Những đặc tính này giúp tài liệu rõ ràng hơn về mặt thị giác, đồng thời nâng cao đáng kể sự hứng thú của các thành viên trong nhóm khi đọc các đặc tả kỹ thuật dài hoặc báo cáo. Khi chia sẻ, chỉ cần tải tệp HTML lên đám mây là có thể dễ dàng xem qua liên kết, tránh tình trạng trình duyệt không hỗ trợ gốc Markdown.

Nguồn hình ảnh: Thariq Shihipar　Các kỹ sư Claude Code đề xuất HTML thay thế Markdown

HTML hay Markdown? Nên suy nghĩ trước khi xuất ra ba câu hỏi

Ý tưởng của Shihipar về việc “HTML thay thế Markdown” nhanh chóng gây tranh luận sôi nổi trong cộng đồng, nhưng trọng tâm thực sự là: Khi nào nên dùng HTML, khi nào nên dùng Markdown?

Các nhà bình luận chuyên về tiền mã hóa, AI như The Smart Ape cho rằng, tranh luận về việc định dạng nào tốt hơn là vô nghĩa, vì lựa chọn định dạng hoàn toàn phụ thuộc vào đối tượng đọc, tần suất chỉnh sửa và vòng đời của tài liệu. Nếu chọn sai định dạng, sẽ tiêu tốn nhiều Token và thời gian chỉnh sửa, thậm chí ảnh hưởng đến độ chính xác của tìm kiếm trong cơ sở dữ liệu.

Ông đề xuất, trước khi yêu cầu Claude Code tạo ra định dạng, hãy cân nhắc ba câu hỏi sau.

⭐Ai sẽ đọc tài liệu này?

Nếu trong tương lai, tài liệu này cần cho Claude hoặc các AI đại lý khác đọc lại, ví dụ như để lập chỉ mục mã nguồn hoặc tham khảo đặc tả kỹ thuật, thì Markdown chắc chắn là lựa chọn tối ưu.

The Smart Ape chỉ ra rằng, HTML chứa nhiều kiểu dáng và thẻ, sẽ tiêu tốn gấp hơn 3 lần Token, đồng thời làm loãng tín hiệu ý nghĩa, khiến AI giảm độ liên quan trong các lần truy vấn sau khoảng 15% đến 25%; nhưng nếu tài liệu là báo cáo dùng một lần để người đọc, thì có thể xem xét dùng HTML.

⭐Tài liệu này sẽ được chỉnh sửa bao nhiêu lần?

Khi chỉnh sửa tệp Markdown, AI thường chỉ cần thay thế vài dòng văn bản để hoàn tất. Trong khi đó, chỉnh sửa tệp HTML có kiểu dáng, AI thường sẽ viết lại cả phần đánh dấu xung quanh. Sau 5 đến 10 lần chỉnh sửa, tệp HTML sẽ xuất hiện hiện tượng “dịch chuyển thẻ”, nội dung có thể pha trộn nhiều hệ thống khoảng cách và cấu hình màu sắc.

The Smart Ape cho rằng, nếu tài liệu cần chỉnh sửa thường xuyên, dùng Markdown sẽ đảm bảo tính ổn định của nội dung, còn HTML chỉ phù hợp để làm định dạng cuối cùng khi xuất bản.

⭐Vòng đời của tài liệu này dài bao nhiêu?

Khả năng lưu trữ của tài liệu cũng là một yếu tố quan trọng. Sau 6 tháng, nhà phát triển có thể dễ dàng tìm kiếm nội dung Markdown cụ thể trong dự án qua từ khóa, nhưng trong HTML, có thể do cấu trúc thẻ phức tạp mà tìm kiếm thất bại.

Ngoài ra, một tệp Markdown từ nhiều năm trước vẫn có thể mở ra thuần túy, trong khi các tệp HTML dựa vào liên kết tài nguyên bên ngoài có thể gặp phải lỗi mất kiểu dáng. Vì vậy, đối với các tài liệu cốt lõi cần lưu trữ và truy xuất lâu dài, nên dựa trên Markdown.

The Smart Ape cho rằng, cách tốt nhất là xem Markdown như một nguồn dữ liệu duy nhất, và dựa vào nhu cầu để động tạo ra HTML phù hợp cho các đối tượng khác nhau.

Nguồn hình ảnh: The Smart ApeHTML hay Markdown? Nên suy nghĩ trước khi xuất ra ba câu hỏi

⭐Dành 30 giây để kiểm tra khả năng đảo ngược

The Smart Ape còn chia sẻ một bài kiểm tra khả năng đảo ngược trong 30 giây, như một tiêu chuẩn cuối cùng.

Trước khi quyết định dùng HTML, hãy tự hỏi: Tài liệu này có thể được chuyển đổi hoàn hảo trở lại định dạng Markdown sạch chỉ bằng một câu lệnh gợi ý không? Nếu câu trả lời là không, điều đó có nghĩa nội dung đã gắn chặt với ngôn ngữ đánh dấu, và tài liệu này trong tương lai sẽ đối mặt với rủi ro khó bảo trì.

Các nhà khoa học máy tính: Mong muốn AI tương tác tiến bước lớn

Dù việc chọn HTML hay Markdown gây tranh cãi trái chiều, nhưng cựu nhà khoa học máy tính của OpenAI, Andrej Karpathy, lại lạc quan.

Ông chỉ ra rằng, việc yêu cầu LLM xuất ra định dạng HTML bằng câu lệnh cuối cùng, rồi mở tệp tạo ra trong trình duyệt, hiện tại thực sự rất hiệu quả, ông cũng đã thành công trong việc khiến AI tạo ra nội dung dạng trình chiếu hoặc mô phỏng.

Ông tin rằng, con người là sinh vật thị giác, và khi công nghệ AI tiến bộ, các định dạng xuất ra sẽ trải qua nhiều giai đoạn nâng cấp. Thậm chí, ông dự đoán rằng, cuối cùng, xu hướng sẽ hướng tới các video tương tác hoặc môi trường mô phỏng do mạng nơ-ron trực tiếp tạo ra.