make-pdf

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

1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill make-pdf-sanjanb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-pdf
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/gstack-make-pdf
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill make-pdf-sanjanb

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, running headers, curly quotes, and clean copy-paste output. ## Core Features & Use Cases - One-command rendering: Run generate on any markdown file to get a PDF with 1in margins, running headers, page numbers, and a CONFIDENTIAL footer by default. - Publication layout: Add a cover page, clickable table of contents, chapter breaks per H1, and author/title metadata with flags like --cover --toc. - Draft watermark and preview: Apply a diagonal DRAFT watermark for work-in-progress documents, or use preview to iterate on HTML in the browser before generating the PDF. - Diagram rendering: Mermaid and Excalidraw code fences render as vector diagrams offline, with per-diagram caption and page-orientation options. - Use Case: You wrote a project memo in markdown and need to send it as a formal document. Run the generate command with your file to produce a finished PDF with headers, page numbers, and clean typography. ## Quick Start Ask the agent to turn your markdown file into a PDF, for example: make a PDF from memo.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 letter.pdf`. The output PDF includes 1in margins, running headers, page numbers, and clean typography by default, with no extra flags needed.

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

Pass the --cover and --toc flags along with --author and --title, for example `generate --cover --toc --author "Name" --title "Title" essay.md out.pdf`. Each top-level H1 starts a new page unless you pass --no-chapter-breaks.

Can I render Mermaid diagrams in a PDF from markdown?

Yes. A column-0 mermaid or excalidraw code fence renders as a vector diagram fully offline using a vendored bundle. Fence options like title, render=false, and page=landscape control captions and page orientation.

Why do emoji show as empty boxes in my generated 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 via apt, dnf, pacman, or apk; set GSTACK_SKIP_FONTS=1 to skip this on managed machines.

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

If the setup check prints MAKE_PDF_NOT_AVAILABLE, the binary has not been built yet. Run ./setup from the gstack repository to build it, then retry the generate command.