md-to-pdf

Converts Markdown documents into A4 PDF-ready HTML handouts with overflow prevention.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill md-to-pdf-hivgb1-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md-to-pdf
Source: https://github.com/hivgb1-ai/do-better-workspace-v2/tree/main/.claude/skills/md-to-pdf
Command: npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill md-to-pdf-hivgb1-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning Markdown notes, lecture materials, or reports into polished printable handouts usually requires manual layout work, and content often overflows page boundaries when printed. This Skill automates the conversion into A4 PDF-ready HTML with a consistent monochrome theme and automatic page overflow prevention. ## Core Features & Use Cases - Markdown to A4 HTML conversion: Parses headings, lists, quotes, tables, and code blocks, then maps them to styled HTML components (cards, steps, quote blocks, highlight boxes). - Page overflow prevention: Groups content into indivisible logical blocks and budgets each page against a 233mm height target so nothing gets cut off when printing. - Monochrome Dark theme with custom override: Ships a brand-neutral black/white theme using Pretendard and Helvetica Neue, and accepts a user-supplied style guide for custom CSS. - Use Case: After a workshop, convert your session-notes.md into a professional handout by simply asking for a handout, then open the generated HTML in a browser and print to PDF. ## Quick Start Ask the AI to create a handout from your Markdown file, for example: "Make a handout from @session-notes.md" and then open the generated HTML file in a browser and print it to PDF.

Frequently Asked Questions about md-to-pdf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Markdown file to a printable PDF handout?

Provide the Markdown file and ask for a handout. The Skill generates a self-contained HTML file with embedded CSS in the same directory, which you open in a browser and save as PDF using Cmd+P or Ctrl+P.

How to prevent content overflow when printing Markdown to A4 pages?

The Skill groups content into indivisible logical blocks and budgets each page against a 233mm height target. Groups that would exceed the limit move to the next page, and section headers are never left alone at a page bottom.

Can I use my own CSS style guide instead of the default theme?

Yes, you can supply your own style guide file and its CSS will replace the default Monochrome Dark theme. The A4 page layout and overflow prevention rules still apply regardless of the custom styling.

What Markdown elements are supported in the HTML conversion?

Headings, paragraphs, blockquotes, ordered and unordered lists, tables, code blocks, and horizontal dividers are mapped to styled components such as card grids, step blocks, quote boxes, and highlight boxes.

Does the generated HTML need external CSS or font files to print?

No external CSS file is needed because all theme styles are inlined in a style block. The only external resource is the Pretendard font loaded from a CDN link in the document head.