make-pdf

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

Updated Aug 9, 2026
One-click install
npx skills add https://github.com/raghavbadhwar/rstack --skill make-pdf-raghavbadhwar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-pdf
Source: https://github.com/raghavbadhwar/rstack/tree/main/make-pdf
Command: npx skills add https://github.com/raghavbadhwar/rstack --skill make-pdf-raghavbadhwar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning markdown into a polished, print-ready PDF usually requires manual typesetting or fragile toolchain setups. This Skill renders markdown into finished PDF documents with proper margins, page numbers, cover pages, clickable tables of contents, and optional DRAFT watermarks, all from a single command. ## Core Features & Use Cases - Markdown to PDF generation: Render any .md file into a PDF with 1in margins, running headers, page numbers, smart typography (curly quotes, em dashes), and a CONFIDENTIAL footer by default. - Publication layout options: Add cover pages, clickable TOCs, chapter breaks at each H1, custom titles/authors, and diagonal DRAFT watermarks via flags like --cover, --toc, and --watermark. - Diagram and image rendering: Mermaid and Excalidraw code fences render as vector diagrams offline, local images are inlined and downscaled to print resolution, and HTML/DOCX outputs are also supported. - Use Case: You wrote a project proposal in markdown and need to send a polished document to stakeholders. Run the generate command with --cover and --toc to produce a finished PDF with a cover page and navigable table of contents. ## Quick Start Ask the agent to turn your markdown file into a PDF, for example: make a PDF from proposal.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 from the command line?

Run the generate command with your markdown file: pdf generate input.md output.pdf. With no flags it produces a clean PDF with running headers, page numbers, and a CONFIDENTIAL footer; add --cover and --toc for a full publication layout.

How do I add a DRAFT watermark to a PDF?

Pass the --watermark flag with your text, for example pdf generate --watermark DRAFT memo.md draft.pdf. This places a diagonal 10% opacity watermark across every page; drop the flag and regenerate when the document is final.

Can mermaid diagrams render inside a generated PDF?

Yes. Column-0 mermaid and excalidraw code fences render as vector diagrams fully offline using a vendored bundle. Add render=false to a fence info string to keep it as a plain code block, and broken fences produce a visible diagnostic block.

Why do emoji show as empty boxes in my PDF on Linux?

Most Linux distributions ship no color-emoji font, so emoji render as empty boxes. The setup script installs fonts-noto-color-emoji on apt, dnf, pacman, or apk systems; set GSTACK_SKIP_FONTS=1 to skip this in CI or offline environments.

What happens when images are missing or remote in the markdown?

Missing local images become visible placeholder spans with a warning, and remote images are blocked by default under the offline posture. Use --allow-network to load external images or --strict to make missing or remote images fail the run.