Initial commit

skills/benchmarking/markdown-to-pdf-converter/README.md

@@ -0,0 +1,71 @@
+# Markdown to PDF Converter
+
+A Claude Code skill for converting markdown documents to professional, print-ready PDFs using pandoc and weasyprint with academic styling.
+
+## Overview
+
+This skill automates the markdown-to-PDF pipeline with:
+- Academic-style CSS (system fonts, proper tables, page breaks)
+- HTML diagram capture via Playwright at retina quality
+- Iterative refinement workflow for complex documents
+
+## Prerequisites
+
+```bash
+# Required
+brew install pandoc
+pip install weasyprint
+
+# Optional (for diagram capture)
+npm install playwright
+npx playwright install chromium
+```
+
+## Usage
+
+Trigger the skill with phrases like:
+- "convert this markdown to PDF"
+- "generate a PDF from this document"
+- "create a professional PDF report"
+
+## Key Features
+
+### Academic Table Styling
+Tables use traditional academic formatting with top/bottom borders on headers and clean cell spacing.
+
+### Smart Page Breaks
+- Headings stay with following content
+- Tables and figures don't split across pages
+- Manual page breaks via `<div style="page-break-before: always;"></div>`
+
+### Figure Centering
+Proper figure centering that works in weasyprint (not all CSS properties are supported).
+
+### Retina-Quality Diagrams
+Playwright captures HTML diagrams at 2x resolution for crisp print output.
+
+## File Structure
+
+```
+markdown-to-pdf-converter/
+├── SKILL.md           # Main skill instructions
+├── README.md          # This file
+├── CHANGELOG.md       # Version history
+├── templates/
+│   ├── pdf-style.css          # Academic CSS stylesheet
+│   └── capture-diagrams.js    # Playwright screenshot script
+├── examples/
+│   └── report-template.md     # Example markdown structure
+├── reference/
+│   └── weasyprint-notes.md    # CSS compatibility notes
+└── workflow/
+    └── iterative-refinement.md # Page break tuning process
+```
+
+## Version
+
+1.0.0 - Initial release based on paralleLLM empathy-experiment-v1.0.pdf
+
+## Author
+
+Connor Skiro