pdf-export

Convert Markdown sources into styled PDF documents with cover, TOC, and appendices.

Updated May 19, 2026
One-click install
npx skills add https://github.com/TimeKast/AgendaInteligente --skill pdf-export-timekast
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pdf-export
Source: https://github.com/TimeKast/AgendaInteligente/tree/main/.agent/skills/utils/pdf-export
Command: npx skills add https://github.com/TimeKast/AgendaInteligente --skill pdf-export-timekast

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires md-to-pdf, puppeteer, chromium, python3, npx, sips, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

Exporting Markdown into polished, consistent PDFs is time-consuming and often inconsistent across stakeholders, templates, and projects.

Core Features & Use Cases

  • Branded PDF Generation from Markdown: Produces professional PDFs from Markdown using md-to-pdf with a consistent TimeKast CSS theme.
  • Optional Cover Page + Logos: Auto-detects TimeKast and client logos from project config or falls back to logo files in the repo root.
  • TOC + Appendices: Generates a table of contents from H2 headings and supports one or more appendices to expand the document.
  • Metadata-driven Styling: Extracts title and key header fields (date, version, stakeholders, author) from the Markdown to populate the cover.

Quick Start

Ask: “Generate a professional PDF from docs/planning/00_DISCOVERY_BRIEF.md using the default TimeKast styling and include the cover, TOC, and detected logos.”

Frequently Asked Questions about pdf-export

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to a branded PDF with a table of contents?▼

To convert Markdown to a branded PDF, this tool uses md-to-pdf with a Puppeteer and Chromium workflow to render documents. It automatically generates a table of contents from H2 headings and applies a configurable CSS stylesheet for professional branding.

Can I add a cover page with logos when exporting Markdown to PDF?▼

Yes, Markdown to PDF export supports optional cover pages with auto-detected logos. It extracts metadata like title, date, and author from Markdown headers and detects project logos from configuration or repository root files to populate the branded cover.

Does the Markdown to PDF workflow support adding appendices for extended documentation?▼

Yes, the Markdown to PDF builder supports inserting one or more appendices to expand the final document. A Python builder assembles and renders combined Markdown sources into the final PDF alongside the generated table of contents and cover page.

What dependencies are required to generate PDFs from Markdown using Puppeteer and Chromium?▼

Generating PDFs from Markdown requires md-to-pdf, Puppeteer, Chromium, Python3, npx, and sips installed in your environment. These dependencies handle the rendering, assembly, and image processing needed to produce the final styled PDF document.

Why does my Markdown to PDF export fail when using a custom CSS stylesheet?▼

Markdown to PDF export failures with custom CSS often stem from missing Chromium or Puppeteer dependencies required by md-to-pdf. Ensure Python3, npx, and sips are properly configured, as the Python builder relies on this environment to render the final PDF.