markdown-to-pdf

Convert Markdown documents into styled PDFs with covers and table of contents.

1.3k|213|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/alchaincyf/huashu-skills --skill markdown-to-pdf-alchaincyf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-pdf
Source: https://github.com/alchaincyf/huashu-skills/tree/main/markdown-to-pdf
Command: npx skills add https://github.com/alchaincyf/huashu-skills --skill markdown-to-pdf-alchaincyf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown2, weasyprint, and includes scripts (resource) components.

What problem does it solve?

Markdown to PDF workflows often require manual formatting to achieve professional typography and layout. This Skill automates the process by converting Markdown into a polished PDF whitepaper with Apple design styling, including covers, table of contents, headers, and footers, saving time and ensuring consistent output.

Core Features & Use Cases

  • Complete Markdown support: code blocks, tables, quotes, lists, and more are rendered with high fidelity.
  • Automatic cover and table of contents generation: produces a professional first page and navigable structure.
  • Apple design aesthetics: SF fonts, clean typography, and dual-column TOC for print-ready PDFs.
  • Use Case: technical documentation, product manuals, whitepapers, tutorials, and reports that require structured, publication-quality PDFs.

Quick Start

Run the converter on a Markdown file to generate a ready-to-share PDF.

Frequently Asked Questions about markdown-to-pdf

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

FAQPage Schema
How do I convert Markdown to a PDF with a table of contents and cover page?

To convert Markdown to a PDF with a table of contents and cover page, this Skill automates the rendering pipeline using markdown2 and WeasyPrint to generate publication-ready documents with automatic covers and navigable structures.

Can WeasyPrint render Markdown code blocks and tables into a whitepaper?

Yes, WeasyPrint renders Markdown code blocks, tables, quotes, and lists into a whitepaper with high fidelity, applying Apple design aesthetics like SF fonts and clean typography for print-ready output.

What is the best way to generate Apple design styled PDFs from Markdown documentation?

The best way to generate Apple design styled PDFs from Markdown documentation is using this automated Skill, which applies SF fonts, dual-column tables of contents, and professional layouts via WeasyPrint for publication-quality results.

Do I need Python to automate Markdown to PDF conversion for technical reports?

Yes, you need a Python environment to automate Markdown to PDF conversion for technical reports, as this Skill implements an end-to-end pipeline relying on the markdown2 and WeasyPrint Python libraries to produce polished output.

Does this Markdown to PDF converter support automated cover generation?

Yes, this Markdown to PDF converter supports automated cover generation, automatically producing a professional first page and a structured table of contents for technical documentation, manuals, and whitepapers.

What are the limitations of using WeasyPrint for Markdown to PDF rendering?

When using WeasyPrint for Markdown to PDF rendering, limitations center on its reliance on Python environments and specific CSS rendering engines, meaning complex dynamic web styling outside its supported scope may not translate perfectly to the final PDF.