make-pdf

Convert URLs, markdown files, and HTML documents to PDF via headless Chromium.

Updated May 27, 2026
One-click install
npx skills add https://github.com/jokerman89/lintel --skill make-pdf-jokerman89
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: make-pdf
Source: https://github.com/jokerman89/lintel/tree/main/skills/make-pdf
Command: npx skills add https://github.com/jokerman89/lintel --skill make-pdf-jokerman89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning chat-based documents like design docs, runbooks, and one-pagers into distributable PDF files usually requires manual export steps and inconsistent tooling. This Skill renders markdown, HTML, or live URLs into print-ready PDFs through a managed headless Chromium pipeline with deterministic markdown conversion. ## Core Features & Use Cases - Multi-format input: Accepts local markdown files, HTML files, or HTTP(S) URLs, converting markdown to HTML via pandoc or markdown-it before rendering. - Print control: Configure paper size (A4/letter), orientation, custom print CSS, and declarative headers/footers with page numbers and dates. - Compliance gates: Blocks rendering of production-host URLs and flags customer-facing content that has not passed the active pack's voice and compliance checks. - Use Case: After finalizing a design doc in a session, run the skill on design-doc.md to produce a 142KB, 8-page PDF ready for distribution to stakeholders. ## Quick Start Ask the agent to convert the file design-doc.md into a PDF using the make-pdf skill with default A4 portrait settings.

Frequently Asked Questions about make-pdf

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

FAQPage Schema
How do I convert a markdown file to PDF from the command line?▼

Run the skill with --input pointing to your .md file. The markdown is converted to HTML via pandoc or markdown-it, styled with a default print stylesheet, then rendered to PDF by headless Chromium at <input-stem>.pdf.

How to save a web page as PDF with custom headers and footers?▼

Pass the page URL as --input along with --header-footer pointing to a YAML file defining header and footer templates. Placeholders like {{page}}, {{total}}, and {{date}} are interpolated during the Chromium print render.

Can I render PDF in letter size or landscape orientation?▼

Yes. Use --format letter to override the default A4 paper size and --orientation landscape to change page orientation. A custom print stylesheet can also be supplied with --print-css.

Why is my generated PDF blank or only a few kilobytes?▼

A PDF under 5KB almost always indicates an empty or broken render. The skill warns explicitly in this case; check that the input content loaded correctly and that no print CSS reference is broken or blocking rendering.

What happens if pandoc is not installed for markdown conversion?▼

The skill falls back to markdown-it for markdown-to-HTML conversion. If neither converter is available, it reports the missing toolchain and stops rather than silently degrading output quality.

When should I not use headless Chromium for PDF generation?▼

Avoid it for live preview during authoring (use the IDE markdown preview) and for multi-page reports needing a table of contents and cross-references, which require a dedicated typesetting tool.