Obsidian Better Export PDF插件字体自定义指南

Obsidian Better Export PDF插件字体自定义指南

obsidian-better-export-pdf Obsidian PDF export enhancement plugin 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-better-export-pdf

在Obsidian笔记应用中，Better Export PDF插件为用户提供了将Markdown文档导出为PDF的强大功能。其中，字体样式的自定义是许多用户关注的焦点。本文将详细介绍如何通过CSS代码片段来全面控制PDF导出时的字体设置。

字体自定义原理

Better Export PDF插件基于CSS的@media print媒体查询实现打印样式控制。通过覆盖CSS变量，用户可以灵活地调整PDF输出时的字体显示效果。这种设计既保持了默认样式的稳定性，又为用户提供了充分的定制空间。

核心CSS变量

插件提供了四个关键的字体控制变量：

1. --font-interface-override：控制界面元素的字体
2. --font-text-override：控制正文文本的字体
3. --font-print-override：专门针对打印输出的字体
4. --font-monospace-override：控制等宽字体的显示

此外，--font-text-size变量可用于调整基础字体大小。

完整配置示例

以下是一个完整的CSS配置示例，展示了如何设置中文楷体作为主要字体：

@media print {
  body {
    --font-interface-override: "霞鹜文楷" !important;
    --font-text-override: "霞鹜文楷" !important;
    --font-print-override: "霞鹜文楷" !important;
    --font-monospace-override: "霞鹜文楷等宽" !important;
    --font-text-size: 30px !important;
  }
}

实际应用技巧

1. 字体回退机制：建议设置多个字体作为备选，例如：

   --font-text-override: "霞鹜文楷", "楷体", serif !important;
   

2. 元素级控制：如需针对特定元素设置字体，可添加更具体的选择器：

   @media print {
     .markdown-preview-view h1 {
       font-family: "思源黑体" !important;
     }
   }
   

3. 字号阶梯设置：可以建立系统的字号比例：

   --font-text-size: 16px !important;
   --font-h1-size: 2.5em !important;
   --font-h2-size: 2em !important;
   

注意事项

1. 字体名称必须与系统中安装的字体名称完全一致
2. 中文字体文件通常较大，可能影响PDF生成速度
3. 使用!important声明确保样式优先级
4. 建议先在Obsidian的实时预览中测试效果再导出

通过合理运用这些CSS定制技巧，用户可以轻松创建出符合个人审美和阅读习惯的PDF文档，充分发挥Better Export PDF插件的强大功能。

obsidian-better-export-pdf Obsidian PDF export enhancement plugin 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-better-export-pdf