make-pdf

Convert markdown files into publication-quality PDFs with covers, TOCs, and watermarks.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aicodepro/ai-agent-nexi --skill make-pdf-aicodepro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-pdf
Source: https://github.com/aicodepro/ai-agent-nexi/tree/main/agent/skills/gstack/make-pdf
Command: npx skills add https://github.com/aicodepro/ai-agent-nexi --skill make-pdf-aicodepro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning markdown into a polished, print-ready PDF usually requires manual layout work in a word processor. This Skill renders markdown directly into a finished PDF with proper margins, page breaks, page numbers, typography, and optional cover pages, so the output is a finished document rather than a draft artifact. ## Core Features & Use Cases - Markdown to PDF generation: Render any .md file into a PDF with 1in margins, running headers, page numbers, curly quotes, and clean copy-paste text. - Publication layout options: Add cover pages, clickable tables of contents, chapter breaks at each H1, and diagonal DRAFT watermarks. - Diagram and image handling: Mermaid and Excalidraw code fences render as vector diagrams offline, and local images are inlined, scaled to print resolution, and never truncated. - Alternate formats: Export the same markdown as a single self-contained HTML file or a DOCX with content fidelity. - Use Case: Ask the assistant to turn a project memo written in markdown into a watermarked draft PDF, then regenerate it without the watermark once finalized. ## Quick Start Ask the assistant to turn your markdown file into a PDF, for example by saying "make a PDF from report.md with a cover page and table of contents".

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?

Run the generate command with your markdown file, for example `generate letter.md output.pdf`. The tool renders the markdown through a Chromium-based pipeline and writes a PDF with proper margins, page numbers, and running headers by default.

How do I add a cover page and table of contents to a PDF from markdown?

Pass the --cover and --toc flags along with optional --title and --author metadata. Each top-level H1 starts a new page, and the generated TOC is clickable.

Can mermaid diagrams render inside a generated PDF?

Yes. Column-zero mermaid and excalidraw code fences render as vector diagrams fully offline using a vendored bundle. A broken fence produces a visible red diagnostic block instead of silent raw code.

Why are remote images blocked when generating a PDF?

Remote http/https images are blocked by default to keep rendering offline and predictable, and they are replaced with a visible placeholder. Pass --allow-network to fetch them, or --strict to make missing or remote images fail the run.

What do I do if the make-pdf binary is not available?

The skill prints MAKE_PDF_NOT_AVAILABLE when the compiled binary is missing. Run ./setup from the gstack repository to build it, then retry the generate command.