传统基础 Markdown 转 PDF 工具最令人头痛的缺陷莫过于国际化多语言文本排版时的“乱码”问题。当渲染引擎在未内嵌字体的情况下遇到中日韩汉字（CJK）、西里尔字母或带重音符的拉丁语系时，往往会将无法识别的字符全部替换为空白方块——业界俗称“豆腐块（Tofu）”。在 md2pdf 中，完整的前端 Unicode 矢量字体嵌入机制确保技术文档在任何终端设备上都能字字清晰、排版优雅。
本文将解析 md2pdf 基于 pdf-lib 与 @pdf-lib/fontkit 的浏览器端字体解析原理、字形子集优化策略，以及消除字符缺失的工程实现。
便携式文档体系中的 Unicode 排版壁垒
原生 PDF 标准规格仅预装了 14 款基础西文字体（如 Helvetica、Times Roman 等），仅涵盖基础 ASCII 及少数西欧符号。
- 豆腐块（Tofu）现象：缺乏对应字体映射的 Unicode 字符会被渲染为空心方框（□），彻底摧毁阅读体验。
- 中日韩（CJK）超大字符集挑战：汉字、假名与谚文的字符数量高达数万个，未经优化的字体体积往往高达几十兆。
- 重音变音符排版：土耳其语（如 ç, ğ, ı, ö, ş, ü）与斯拉夫西里尔字母需要精准的编码支持以保障版面工整。
Multilingual Glyph Coverage in md2pdf:
- Latin & Extended Latin: English, Spanish, French, Portuguese, Turkish
- Cyrillic Alphabets: Russian, Ukrainian, Bulgarian
- East Asian Ideographs: Simplified Chinese (简体中文), Japanese (日本語)
- Hangul Syllables: Korean (한국어)借助 @pdf-lib/fontkit 实现高性能前端字体嵌入
md2pdf 运用 @pdf-lib/fontkit 引擎在用户浏览器本地直接解析 TrueType（TTF）与 OpenType（OTF）字体字形表：
- 按需前端加载：根据文档内容语种，精准获取经过严谨调校的高品质开源字体（如 Noto Sans、思源黑体及 Roboto Mono）。
- 字符流矢量映射：
fontkit逐字扫描 Markdown 文本中的 Unicode 码点，并在字体表中准确提取对应的贝塞尔矢量轮廓。 - 原生嵌入 PDF 骨架：
pdf-lib将提取的矢量外轮廓直接写入 PDF 内部字典流，使生成的 PDF 成为 100% 独立便携的电子文档。
覆盖全部九种官方语言的原生排版支持
md2pdf 为全球主流技术团队覆盖的九种语言提供原生级的出版排版：
- 英语、西班牙语、法语、葡萄牙语：利落的西文排版，完美兼容锐音符、钝音符、抑扬符、波浪号及变音符。
- 土耳其语：完美呈现带点与不带点的 “i”（
İ/i、I/ı）及各类特殊声母。 - 俄语（西里尔字母）：笔画比例匀称典雅，与拉丁大标题浑然一体。
- 简体中文、日语与韩语：全量 CJK 字形覆盖，保证结构复杂的汉字与韩语音节字距平衡、留白适度。
零依赖离线便携阅读体验
得益于字形轮廓已直接嵌入到 PDF 文件的二进制数据中：
无论接收文档的读者使用的是 Windows、macOS、Linux，还是手机平板移动设备，即便其系统内部未安装任何中日韩或俄文字体，打开文件时看到的版面依然与原作者生成时完全一致。
在 md2pdf 中轻松输出多语言技术文献
无论您需要排版一份中文架构方案、日文 API 接口手册还是多语言混合的技术标准，md2pdf 均可在毫秒之间全自动完成字形嵌入与版式校准。即刻导入您的 Markdown 文档，彻底告别豆腐块与字体缺失烦恼。
制作你自己的 README PDF
免费、无需登录，全程在浏览器本地完成。