Thariq Shihipar, phụ trách Claude Code tại Anthropic, vừa công khai đề xuất chuyển định dạng đầu ra của AI agent từ Markdown sang HTML. Theo ông, Markdown từng là lựa chọn phổ biến khi làm việc với agent, nhưng ngày càng bộc lộ nhiều hạn chế, đặc biệt khi AI được dùng để tạo tài liệu phục vụ công việc.

Shihipar cho biết các tệp Markdown dài hơn 100 dòng thường rất khó theo dõi. Định dạng này cũng hạn chế khả năng thể hiện màu sắc, sơ đồ và biểu đồ. Việc chia sẻ không thuận tiện, trong khi người dùng ngày càng ít tự chỉnh sửa tài liệu và thường giao lại cho Claude xử lý, khiến lợi thế lớn nhất của Markdown dần suy giảm.

Theo Shihipar, HTML có bốn ưu điểm chính.

Đầu tiên là khả năng thể hiện thông tin. HTML có thể hiển thị bảng biểu, bố cục bằng CSS, minh họa SVG, tương tác bằng JavaScript, dữ liệu không gian và hình ảnh. Ông cho rằng với HTML, Claude không còn phải “ứng biến” bằng cách mô tả màu sắc bằng ký tự Unicode hay vẽ sơ đồ ASCII như khi dùng Markdown.

Ưu điểm thứ hai là khả năng đọc. HTML cho phép tổ chức nội dung trực quan hơn thông qua tab, hình minh họa và liên kết, đồng thời hỗ trợ giao diện tương thích trên thiết bị di động. Theo ông, so với các tài liệu Markdown dài và khó đọc trong môi trường doanh nghiệp, tài liệu HTML có khả năng được mở và đọc cao hơn đáng kể.

Thứ ba là tính thuận tiện trong chia sẻ. Markdown không được trình duyệt hiển thị trực tiếp nên thường phải gửi dưới dạng tệp đính kèm. Với HTML, người dùng chỉ cần đưa tệp lên một nền tảng lưu trữ như S3 là có thể chia sẻ bằng đường link. Shihipar cho rằng điều này giúp tăng đáng kể khả năng đồng nghiệp thực sự mở xem các tài liệu như kế hoạch, báo cáo hay tài liệu thuyết minh phục vụ PR.

Ưu điểm thứ tư là khả năng tương tác hai chiều. Tài liệu HTML có thể gắn slider hoặc nút bấm để điều chỉnh trực tiếp các tùy chọn thiết kế, sau đó sao chép kết quả trở lại Claude Code. Theo Shihipar, đây là điều Markdown không làm được.

Shihipar cho biết ông hiện dùng HTML cho nhiều mục đích như lập kế hoạch, review code, dựng prototype thiết kế, viết báo cáo và tạo công cụ chỉnh sửa tùy biến. Ở giai đoạn lập kế hoạch, ông thường đặt nhiều phương án song song trong cùng một tệp HTML để so sánh nhanh.

Trong review code, ông nhận định một tài liệu giải thích bằng HTML hiệu quả hơn chế độ diff mặc định của GitHub, nên thường đính kèm một tài liệu HTML cho mỗi PR. Với các công cụ chỉnh sửa tùy biến, ông tạo những tiện ích dùng một lần như công cụ kéo thả hoặc trình chỉnh cấu hình theo biểu mẫu, đồng thời luôn bổ sung nút sao chép kết quả ở bước cuối.

Giải thích lý do sử dụng Claude Code cho cách làm này, Shihipar cho biết công cụ có thể đọc nhiều nguồn ngữ cảnh để tạo HTML, từ hệ thống tệp, MCP như Slack và Linear, đến lịch sử Git và trình duyệt.

Dù vậy, ông cũng thừa nhận HTML có nhược điểm. Thời gian tạo nội dung dài hơn Markdown từ 2 đến 4 lần, việc theo dõi khác biệt trong quản lý phiên bản phức tạp hơn và mức tiêu tốn token cũng cao hơn. Tuy nhiên, theo Shihipar, đổi lại người dùng có thể theo sát hơn những gì Claude đang làm. Ông nói rằng thay vì lo phải giao quyết định cho Claude vì không đọc kỹ kế hoạch, hiện ông nắm rõ công cụ này đang thực hiện điều gì tốt hơn trước.