Emoji trong PDF từng được xem là chuyện trang trí. Bây giờ thì không.

Trong tài liệu gửi cho khách hàng, emoji thường mang thông tin thật:

Hóa đơn có thể dùng ✅ cho đã thanh toán, 🎁 cho phần thưởng, ⭐ cho đánh giá, hoặc 🔥 cho ưu đãi giới hạn.
Thông báo giao hàng có thể dùng 📦, 🚚 và 🙏 làm tín hiệu trạng thái nhanh.
Hồ sơ hỗ trợ khách hàng có thể chứa tin nhắn WhatsApp, LINE, KakaoTalk hoặc WeChat, nơi emoji là một phần của bằng chứng.
Chứng nhận, huy hiệu, coupon, vé hoặc thẻ khách hàng thân thiết có thể dùng 🏆, 🎓, 🎉 hoặc 💯 như một phần nhận diện thị giác.

Nếu emoji biến mất, thành ô vuông trống, hoặc làm PDF phình thêm hàng trăm KB, tài liệu không còn phản ánh đúng nội dung gốc. Ở quy mô lớn, đó là vấn đề sản phẩm, lưu trữ, băng thông, email, lưu trữ hồ sơ và đôi khi là tuân thủ.

“Hỗ trợ emoji” không phải một checkbox. Trình tạo PDF có thể dựa vào font của browser hoặc OS, yêu cầu người gọi cấu hình font emoji, chuyển emoji thành image/vector artwork, hoặc embed dữ liệu color font. Các cách này đều có thể chạy, nhưng tradeoff khác nhau.

Vấn đề thực tế: hỗ trợ và dung lượng

Emoji màu khó trong PDF vì chúng không phải glyph đen trắng thông thường. PDF Association tóm tắt rõ vấn đề: OpenType color fonts có nhiều format cạnh tranh, nhưng các format này không native trong PDF đơn giản như outline fonts truyền thống.

Vì vậy renderer phải chọn cách biểu diễn:

dùng color fonts của browser hoặc OS;
embed hoặc subset dữ liệu font emoji;
chuyển emoji thành image hoặc vector artwork;
hoặc fallback sang monochrome glyph, missing-glyph box hoặc plain text.

Một hai emoji có thể không đáng kể. Nhưng với receipt, coupon, chat export hoặc support archive nhiều emoji, khác biệt trở nên rất rõ.

Benchmark nhỏ: 50 emoji phổ biến

Ngày 20 tháng 5 năm 2026, chúng tôi chạy local smoke test trên cùng một mẫu A4 một trang:

một bản chỉ có plain text;
một bản có 50 emoji phổ biến trong body;
Chrome 148 headless print-to-PDF;
gPdf local generation dùng cùng bộ 50 emoji.

Đây không phải universal benchmark cho mọi tài liệu hoặc mọi phiên bản engine. Nó là cách đơn giản để thấy hành vi file size khi có nhiều emoji màu khác nhau.

Renderer	Plain PDF	Same page with 50 emoji	Increase	Ratio
Chrome 148 print-to-PDF	31,250 bytes	435,630 bytes	+404,380 bytes	13.94x
gPdf local generation	8,766 bytes	43,466 bytes	+34,700 bytes	4.96x

Output của Chrome embed AppleColorEmoji Type 3 subsets. Đó là cách hợp lệ để emoji hiển thị, nhưng tác động lên file size trong mẫu này rất rõ.

Output của gPdf không embed toàn bộ color emoji font. Bản có emoji lớn hơn bản text là điều hợp lý: artwork màu cần được biểu diễn ở đâu đó. Khác biệt là output tăng theo emoji artwork thực sự dùng trong document, không theo một browser/OS font path rộng.

Câu hỏi mua hàng quan trọng không phải “một mặt cười có hiện trên laptop của tôi không?”, mà là:

Khi document chứa hàng chục emoji khác nhau và PDF được tạo trong production systems thực tế, chuyện gì xảy ra?

Các PDF generator khác xử lý emoji thế nào

So sánh công bằng không phải “mọi công cụ khác đều lỗi”. Nhiều công cụ PDF trưởng thành hỗ trợ color emoji. Vấn đề là họ hỗ trợ bằng cách nào, và điều đó có nghĩa gì cho setup, tính ổn định và dung lượng output.

Puppeteer, Chrome và API dựa trên Chromium

Puppeteer dùng đường xuất PDF của Chrome. Tài liệu mô tả page.pdf() là tạo PDF của page với print media type, và guide nói mặc định nó chờ fonts được tải. Điều này hữu ích khi source of truth đã là web page.

Với structured documents nhiều emoji, tradeoff là output phụ thuộc browser/font environment. Trong mẫu local của chúng tôi, Chrome hiển thị emoji đúng, nhưng file tăng từ 31 KB lên 436 KB.

Điều đó không có nghĩa Puppeteer sai. Nó trước hết là browser automation tool. Nếu cần capture một web page có sẵn, nó phù hợp. Nếu cần receipts, labels, tickets, statements hoặc support records nhỏ gọn và repeatable, browser path có thể nặng.

DocRaptor và Prince

DocRaptor bọc Prince, và Prince là HTML-to-PDF engine mạnh. Nó đặc biệt phù hợp khi input thực sự là HTML/CSS và document cần các tính năng paged media phức tạp.

Thông báo Pipeline 9 / Prince 14 của DocRaptor liệt kê rõ color emoji support. Prince 14 release notes cũng liệt kê SVG-in-OpenType, CBLC/CBDT color emoji fonts, Apple sbix và emoji tag sequences. Vì vậy claim đúng không phải “DocRaptor không render được emoji”.

Ranh giới chính xác hơn: DocRaptor/Prince là đường HTML-to-PDF chất lượng cao; gPdf là đường structured JSON-to-PDF. Với tài liệu structured nhiều emoji, khi input vốn đã là data, gPdf tránh đẩy vấn đề qua một HTML/CSS renderer tổng quát.

PDFreactor

PDFreactor cũng hỗ trợ color emoji. Manual nói color emoji được dùng mặc định, và hỗ trợ các color font formats như CBDT, SBIX và OpenType-SVG.

Manual đó cũng nêu hạn chế: PDF size lớn hơn khi dùng OpenType-SVG, và không có selection/copying trong color-font path đó. Đây là tradeoff mà team cần hiểu trước khi xem “emoji support” là yes/no feature.

iText và pdfHTML

iText có thể tạo emoji khi document có font program vẽ được các characters đó. Official pdfHTML emoji guide cho thấy pattern: thêm emoji-capable font vào FontProvider, rồi chạy conversion.

Cách này mạnh với team muốn SDK-level control. Nhưng font setup, testing, deployment và long-term maintenance thuộc về application team.

Vì sao coverage quan trọng

Dễ test sai thứ. Renderer hiển thị được 😂 không có nghĩa nó xử lý được emoji người dùng thật gửi.

Thực tế có:

variation selectors;
skin-tone modifiers;
zero-width-joiner sequences;
country flags và tag sequences;
emoji trộn với CJK, Arabic, Latin và các script khác;
PDF viewers cũ và enterprise document pipelines.

Với customer documents, consistency là một phần của sản phẩm. Support transcript không nên hiển thị emoji khác nhau theo server. Receipt không nên có status mark trên macOS nhưng thành box trong Linux container. Marketplace không nên bắt mọi merchant cài cùng một emoji font stack.

Quan điểm của gPdf đơn giản: color emoji phải hoạt động trong generated PDFs mà không yêu cầu customer cài emoji fonts, tinh chỉnh browser runtime, hoặc mặc định chấp nhận output files lớn.

Emoji quan trọng nhất ở đâu

PDF nhiều emoji không chỉ nằm trong consumer marketing. Chúng cũng xuất hiện trong hệ thống vận hành.

Loại document	Vì sao emoji quan trọng
Receipts and vouchers	Status, reward, rating và promotion là một phần customer experience.
Delivery and booking confirmations	confirmed, packed, shipped, delivered dễ scan hơn.
Customer-support records	Chat export mất tone và evidence nếu bỏ emoji.
Community and social archives	Emoji là một phần cuộc trò chuyện.
Certificates and achievement badges	Trophy, graduation và celebration symbols có thể là một phần design.
Multilingual customer PDFs	Emoji truyền status cue qua ranh giới ngôn ngữ.

Vì vậy file size quan trọng. Tăng 400 KB một lần nghe nhỏ. Với 100,000 receipt mỗi tháng, nó thành storage, bandwidth, email deliverability, mobile download time và archive cost. Ở quy mô chat export, tác động còn lớn hơn.

gPdf phù hợp ở đâu

gPdf không cố trở thành browser đầy đủ hoặc thay thế mọi HTML-to-PDF engine. Nếu source document là web page tùy ý, layout editorial phức tạp, hoặc live dashboard có JavaScript charts, hãy dùng browser hoặc HTML-to-PDF engine trưởng thành.

gPdf được xây cho trường hợp khác:

input đã là structured data;
output cần predictable;
system chạy high volume;
PDF phải compact;
cùng payload cần output consistent giữa environments;
emoji, CJK, barcodes, PDF/A và metadata là product requirements.

Với workload đó, emoji support nên rất bình thường. Bạn nên đưa status, sentiment và customer-language cues vào document mà không biến PDF generation thành dự án cài font.

Nên hỏi PDF vendor điều gì

Khi đánh giá emoji, đừng chỉ xem screenshot:

Có generate được PDF với 50 emoji phổ biến khác nhau không?
File size có và không có emoji là bao nhiêu?
Output có phụ thuộc operating-system fonts không?
Customer có phải install/register emoji font không?
ZWJ sequences, flags và variation selectors được xử lý thế nào?
Output có stable sau runtime upgrades không?
Emoji behavior có documented không, hay chỉ là side effect của host environment?

Câu trả lời sẽ cho biết emoji support là product capability thật hay chỉ là kết quả tình cờ của runtime.

Emoji màu trong PDF: hỗ trợ, dung lượng file và giá trị thực tế