pdf-generation

此技能提供了一套专业级的工作流程，用于将 Markdown 文件转换为高质量的 PDF。它建立在 Pandoc 和 Eisvogel 模板之上，通过 EB Garamond 字体提供精致的排版，非常适合制作白皮书、技术文档、研究手稿和营销资料。该工具专门设计用于处理英文和俄文字符集，确保多语言用户的专业美感。

• 使用 Pandoc 和 xelatex 引擎从 Markdown 自动生成高保真度的 PDF。

• 双重布局架构：适用于传统桌面/打印场景的 A4 (210mm x 297mm) 以及适用于 Telegram 机器人或移动设备的 6x9 英寸（移动设备优化）排版。

• 智慧主题管理，通过 YAML frontmatter 为特定文件类型（如白皮书、营销、研究、技术）提供颜色编码。

• 先进的排版支持，特别整合了 EB Garamond 字体，用于高质量的俄文和英文文档渲染。

• 包含预处理工具（如 fix_markdown.py），通过解决常见的 Markdown 不一致问题，确保嵌套列表、标题和间距的正确渲染。

• 原生支持封面页、目录 (TOC) 以及通过 YAML frontmatter 自定义 metadata。

• 专为需要在多个平台保持文档一致性的技术写作者、研究人员和创作者而设计。

• 使用前需在主机系统上安装 Pandoc 和 LaTeX (MacTeX) 以进行最终渲染。

• 推荐通过 scripts/generate_pdf.py 进行自动化管道整合，允许用户通过命令行参数指定样式、语言和布局偏好。

• 针对 Telegram 整合的代理，默认提供移动设备优化输出，通过 10pt 字体和 1.2 行距提升在小屏幕上的可读性。

• 用户应遵守建议的 Markdown 最佳实践，例如在列表前确保有空行，以获得最佳的 PDF 输出效果。

• 此工作流程具有极高的灵活性，用户可以通过简单的 bash 指令或将 Python 脚本整合到自己的 AI 代理管道中来触发生成。