make-pdf

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

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/abdulazeezoj/monovella-poc --skill make-pdf-abdulazeezoj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-pdf
Source: https://github.com/abdulazeezoj/monovella-poc/tree/main/.agents/skills/gstack/make-pdf
Command: npx skills add https://github.com/abdulazeezoj/monovella-poc --skill make-pdf-abdulazeezoj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires html-to-docx.

What problem does it solve? Turning markdown into a polished, print-ready PDF usually requires manual layout work in a word processor or fragile pandoc pipelines. This Skill renders markdown directly into a finished PDF with proper margins, page numbers, cover pages, clickable tables of contents, and even rendered mermaid and excalidraw diagrams, all from one command. ## Core Features & Use Cases - Publication-quality PDF generation: Renders markdown with 1in margins, running headers, page numbers, curly quotes, optional cover pages, clickable TOCs, and diagonal DRAFT watermarks. - Diagram and image handling: Renders mermaid and excalidraw code fences as vector diagrams, inlines local images at print resolution, and auto-promotes wide diagrams to landscape pages. - Multiple output formats: Produces PDF, single-file self-contained HTML, or DOCX (content fidelity) from the same markdown source. - Use Case: You finish a design memo in markdown and need to circulate a formal version. Run the generate command with --cover --toc to produce a PDF with a cover page, clickable table of contents, and page numbers, or add --watermark DRAFT while it is still under review. ## Quick Start Ask the assistant to turn your markdown file into a PDF, for example: make a PDF of essay.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: `$P generate letter.md` writes a PDF to /tmp, or pass an explicit output path. Add --cover and --toc for a cover page and clickable table of contents.

How do I add a DRAFT watermark to a PDF from markdown?

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

Can mermaid diagrams be rendered inside a PDF?

Yes. A column-0 ```mermaid or ```excalidraw fence in the markdown renders as a vector diagram offline via a vendored bundle. A broken fence produces a visible red diagnostic block with the parse error rather than silent raw code.

Why does PDF generation fail with 'no browser available'?

Exit code 4 means neither the Aside browser (macOS 15+) nor the fallback headless browser is available. Open the Aside app, or run ./setup in the gstack repo to build the fallback browser, then retry.

Does the markdown to PDF converter fetch remote images?

No, remote http/https images are blocked by default and replaced with a visible placeholder to preserve offline posture. Pass --allow-network to fetch them, or --strict to make missing or remote images fail the run in CI.

Can I export markdown to Word or HTML instead of PDF?

Yes. Use --to html for a single self-contained HTML file with inline diagrams and data-URI images, or --to docx for Word output with content fidelity where diagrams are embedded as PNG rasters.