huashu-md-to-pdf_skill

Overview

This skill converts Markdown documents into professional, Apple-style PDF whitepapers with book-grade typography and automated layout. It supports full Markdown features (code blocks, tables, blockquotes, lists) and produces a cover, clickable table of contents, headers and footers automatically. The output is optimized for technical documents, whitepapers, tutorials, and reports that need polished, print-ready layout.

How this skill works

The tool parses your Markdown into structured HTML, applies an Apple-inspired CSS theme (SF fonts, modern color palette, controlled widows/orphans) and renders the final PDF via an HTML-to-PDF engine. It extracts heading numbers to build a dual-column clickable table of contents, handles pagination and keeps code blocks and tables intact across pages. Configuration options are available to adjust colors, font sizes, and cover metadata.

When to use it

• Producing a professional whitepaper or product brief from Markdown
• Creating technical guides or tutorials with code samples and tables
• Converting README-style docs into print-ready PDFs for distribution
• Preparing investor or research reports that need a polished design
• Generating single-file deliverables (cover + TOC + formatted body)

Best practices

• Use numbered chapter headings (e.g., '## 1. Title' and '### 1.1 Subtitle') for accurate TOC extraction
• Wrap code samples with triple backticks and specify language for syntax styling
• Keep large tables and long images mindful of page breaks; use standard Markdown table syntax
• Adjust CSS variables in the script for brand colors, font sizes, or cover layout before batch conversion
• Compress large images to reduce final PDF size

Example use cases

• Convert a technical product guide (tech-guide.md) into a branded PDF for customers
• Turn a research document into a whitepaper with automated cover and TOC for printing
• Compile a multi-section tutorial with code samples into a single downloadable PDF
• Produce investor-facing reports with consistent headers, footers, and page numbers