pdf-generation

This skill provides a robust, professional-grade workflow for converting Markdown documents into high-quality PDFs. It is built upon Pandoc and the Eisvogel template, offering sophisticated typography through the EB Garamond font, making it ideal for creating white papers, technical documentation, research manuscripts, and marketing collateral. The tool is specifically designed to handle both English and Russian character sets, ensuring professional aesthetics for multilingual users.

• Automated PDF generation from Markdown using Pandoc and xelatex engine for high-fidelity typesetting.

• Dual-layout architecture: A4 (210mm x 297mm) for traditional desktop/print contexts and 6x9 inch (phone-optimized) for seamless reading on Telegram bots or mobile devices.

• Intelligent theme management with color-coded YAML frontmatter for specific document types like White Papers (blue), Marketing (green), Research (purple), and Technical (gray).

• Advanced typographical support, specifically integrating EB Garamond for high-quality Russian and English document rendering.

• Preprocessing utilities, such as the included fix_markdown.py, ensure correct rendering of nested lists, headings, and spacing by addressing common Markdown inconsistencies.

• Native support for title pages, tables of contents (TOC), and customizable metadata via YAML frontmatter.

• Intended for technical writers, researchers, and creators who need document consistency across platforms.

• Requires Pandoc and LaTeX (MacTeX) installed on the host system to perform final rendering.

• Recommended usage involves scripts/generate_pdf.py for automated pipeline integration, allowing users to specify styles, languages, and layout preferences as command-line arguments.

• Mobile-friendly output is the default configuration for Telegram-integrated agents, providing 10pt font and 1.2 line spacing to enhance readability on small screens.

• Users should adhere to the provided Markdown best practices, such as ensuring blank lines before lists and proper indentation, to achieve the cleanest PDF output.

• The workflow is highly flexible, allowing users to trigger specific generations via simple bash commands or by integrating the provided Python scripts into their own AI agent pipelines.