字体配置

.font ^{文档 ↗} 函数用于覆盖全局字体配置。

字族参数

你可以从以下任意来源加载一个字族（区分大小写）：

• 文件：path/to/font.ttf
• URL：https://example.com/font.ttf
• 系统字体：Arial、Times New Roman
• Google Fonts：GoogleFonts:Roboto、GoogleFonts:Noto Sans（注意：在查看时需要联网）

该函数提供以下可选参数来设置自定义字族：

• main：所有文本内容的字族。如果当前主题没有为标题指定不同的字体，此设置也会应用于标题。
• heading：标题（标题文字）的字族。覆盖 main。
• code：代码块与行内代码的字族。覆盖 main。

示例：

.font {fonts/Inter.ttf} heading:{GoogleFonts:Poppins} code:{Courier New}

字体资源由媒体存储系统 处理。这确保了例如 HTML 输出会将本地字体包含在输出目录中，从而提高可移植性。

请注意，系统字体可能并未安装在所有设备上。虽然这不应影响 PDF 输出，但在分享 HTML 输出时可能会产生问题。

其他参数

• size：基础字体尺寸 。其他元素（如标题）会相应缩放。例如 12px。

多语言文档的回退

多个 .font 调用会创建相互重叠的字体配置。只要某个字体配置包含所渲染字符的字形，它就会覆盖前一个配置；否则，Quarkdown 会使用前一个字体配置作为回退。

这对于多语言文档尤为有用，例如同时包含拉丁字符与 CJK（中文、日文、韩文）字符的文档。例如，你可以为拉丁字符设置主字体，并为 CJK 字符设置回退字体，如下例所示。

示例 1

.font {GoogleFonts:Ma Shan Zheng}
.font {GoogleFonts:Corinthia}