# Make PDF

> Convert markdown or brain pages into a polished PDF using available local document tooling.

- Skill: `mphaxise/make-pdf` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mphaxise/make-pdf`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mphaxise/make-pdf/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: mphaxise (https://skillmd.com/u/mphaxise)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mphaxise/make-pdf

---


# Make PDF

Use this skill when the user asks to turn markdown, a report, or a brain page into a PDF.

## Workflow

1. Identify the source markdown file.
2. Check whether it is a brain page with YAML frontmatter; if so, preserve the source and strip frontmatter only for rendering.
3. Choose the best available renderer:
   - upstream `gstack make-pdf` if installed
   - Pandoc, browser print, or repo-local tooling if available
4. Render with readable margins, page numbers, links, and a table of contents when appropriate.
5. Verify the output file exists and report the path.

## Current Upstream Coverage

- Support memo/letter and publication layouts, including cover pages, tables of contents, and chapter breaks when appropriate.
- Render Mermaid or Excalidraw source as diagrams when the available renderer supports it.
- Scale images without truncation and fail clearly when required assets are missing.
- Support Markdown, single-file HTML, and Word inputs when the installed document runtime can convert them faithfully.
- Use preview output for fast iteration and a strict CI mode when the caller needs missing assets or rendering failures to stop the run.
- Keep confidentiality footers and draft watermarks opt-in and driven by the source's status.

## Guardrails

- Do not mutate the source markdown to make the PDF.
- Do not invent a PDF path if rendering failed.
- Mark drafts clearly when the source is draft content.