pdf-builder

Files (1)

• SKILL.md

SKILL.md (first lines)

# PDF Builder Skill

## Cuándo usar esta skill
- Generar un reporte, factura, o documento en PDF
- Convertir Markdown a PDF con formato profesional
- Crear PDFs desde plantillas HTML
- Generar PDFs desde páginas web existentes

## Opciones disponibles

| Herramienta | Input | Ideal para | Requiere |
|-------------|-------|-----------|---------|
| Pandoc + LaTeX | Markdown | Documentación técnica, papers | pandoc + LaTeX |
| WeasyPrint | HTML/CSS | Facturas, reportes con CSS | Python |
| Puppeteer/Playwright | HTML/URL | Screenshots, documentos web | Node.js |
| reportlab | Python | PDFs programáticos | Python |
| fpdf2 | Python | PDFs simples | Python |

## Opción 1: Pandoc (Markdown → PDF)

```bash
# Instalar pandoc
# https://pandoc.org/installing.html
# + LaTeX: tlmgr install collection-latex

# Conversión básica
pandoc documento.md -o documento.pdf

# Con tema y opciones
pandoc documento.md \
  --pdf-engine=xelatex \
  -V geometry:margin=2cm \
  -V fontsize=12pt \
  -V lang=es \
  -o documento.pdf

# Con template personalizado
pandoc documento.md \
  --template=mi-template.tex \
  --variables-file=variables.yaml \
  -o documento.pdf

# Con tabla de contenidos
pandoc documento.md --toc --toc-depth=3 -o documento.pdf
```

## Opción 2: WeasyPrint (HTML/CSS → PDF)

```bash
pip install weasyprint
```

```python
from weasyprint import HTML, CSS
from pathlib import Path

def markdown_to_pdf(markdown_text: str, output_path: str, title: str = "Documento"):
    """Convertir Markdown a PDF via HTML con WeasyPrint"""
    import markdown
    
    # Convertir Markdown a HTML
    md = markdown.Markdown(extensions=['tables', 'fenced_code', 'toc'])
    html_body = md.convert(markdown_text)
    
    # Template HTML completo con estilos
    html_content = f"""<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title>{title}</title>
<style>
  @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700&display=swap');
  
  @page {{
    margin: 2.5cm;
    @bottom-center {{
      content: counter(page) " / " counter(pages);
      font-size: 10pt;
      color: #666;
    }}
  }}
  
  body {{
    font-family: 'Inter', sans-serif;
    font-size: 11pt;
    line-height: 1.6;
    color: #333;
  }}
  
  h1 {{ font-size: 24pt; color: #1a1a1a; border-bottom: 2px solid #2B5CE6; padding-bottom: 8px; }}
  h2 {{ font-size: 16pt; color: #1a1a1a; margin-top: 24px; }}
  h3 {{ font-size: 13pt; color: #333; margin-top: 16px; }}
  
  code {{
    background: #f5f5f5;
    padding: 2px 6px;
    border-radius: 4px;
    font-family: 'Courier New', monospace;
    font-size: 10pt;
  }}
  
  pre {{
    background: #f5f5f5;
    padding: 16px;
    border-radius: 8px;
    overflow: hidden;
    border-left: 4px solid #2B5CE6;
  }}
  
  pre code {{
    background: none;
    padding: 0;
  }}
  
  table {{
    width: 100%;
    border-collapse: collapse;
    margin: 16px 0;
  }}

From garri333/Skills, MIT.

More from garri333/Skills