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 代理管道中來觸發生成。