陌讯skills聚合平台

pdf-best-practices

📁 pdfnoodle/pdf-best-practices 📅 9 days ago
3
总安装量
3
周安装量
#61461
全站排名
安装命令
npx skills add https://github.com/pdfnoodle/pdf-best-practices --skill pdf-best-practices

Agent 安装分布

gemini-cli 3
github-copilot 3
codex 3
kimi-cli 3
amp 3
opencode 3

Skill 文档

PDF Best Practices Skill

Comprehensive guidelines for creating HTML that renders perfectly as PDF documents.

┌─────────────────────────────────────────────────────────────────────────────┐
│                         HTML to PDF Pipeline                                 │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│   ┌──────────┐    ┌──────────────┐    ┌─────────────┐    ┌──────────────┐  │
│   │  HTML    │───▶│  PDF Engine  │───▶│  Pagination │───▶│  Final PDF   │  │
│   │ Content  │    │  (Puppeteer) │    │  & Layout   │    │  Document    │  │
│   └──────────┘    └──────────────┘    └─────────────┘    └──────────────┘  │
│        │                                     │                              │
│        ▼                                     ▼                              │
│   ┌──────────┐                        ┌─────────────┐                       │
│   │  CSS     │                        │ Page Breaks │                       │
│   │  Styles  │                        │  & Margins  │                       │
│   └──────────┘                        └─────────────┘                       │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Quick Reference

I want to… Read this
Set up document structure correctly Document Setup
Control page breaks Page Breaks
Format tables for PDF Tables
Handle images properly Images
Optimize content density Content Density
Set up colors and backgrounds Colors & Backgrounds
Add headers, footers, page numbers Headers & Footers
Create specific document types Document Types

Start Here

Building a new PDF document?

  1. Start with Document Setup for the HTML structure
  2. Review Page Breaks to prevent awkward splits
  3. Check Content Density to avoid sparse pages

Working with data tables?

  1. Read Tables for formatting and header repetition
  2. Apply Page Breaks to prevent row splitting

Document has images?

  1. Follow Images for sizing and positioning
  2. Use Page Breaks to keep images with captions

Creating a specific document type?

  1. Check Document Types for type-specific guidelines
  2. Available types: Invoice, Report, Certificate, Letter, Table-heavy, Image-heavy

Default Configuration

When generating PDFs, use these recommended parameters:

{
  "format": "A4",
  "margin": {
    "top": "40px",
    "right": "40px",
    "bottom": "40px",
    "left": "40px"
  },
  "printBackground": true
}

Quick Checklist

Before generating any PDF:

  • Complete HTML structure with DOCTYPE, html, head, body
  • CSS includes @page rule with A4 size
  • Body has -webkit-print-color-adjust: exact
  • All images have explicit width/height
  • Tables use thead/tbody structure
  • page-break-inside: avoid on logical content blocks
  • Headings have page-break-after: avoid
  • No excessive whitespace or sparse pages
  • Font sizes are 9pt or larger
  • Colors have sufficient contrast
  • pdfParams includes format, margins, and printBackground: true
GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台
本页面由 陌讯 Skills 聚合平台 收录整理，数据定期更新。