pdf-to-markdown

name	pdf-to-markdown
description	Convert PDF files to Markdown format and create PDFs from Markdown. Use when the user asks to read, analyze, extract content from PDFs, or generate PDF documents.

Read a PDF file

Converts a PDF to Markdown and prints to stdout:

uv run --with pymupdf4llm ~/.kiro/skills/pdf-to-markdown/scripts/pdf_to_markdown.py "<path_to_pdf>"

Save as .md file:

uv run --with pymupdf4llm ~/.kiro/skills/pdf-to-markdown/scripts/pdf_to_markdown.py "<path_to_pdf>" "<output.md>"

Write a PDF file

Preferred: Directly from markdown content (no intermediate file)

Pipe markdown content directly using --stdin:

echo '<markdown_content>' | uv run --with pymupdf ~/.kiro/skills/pdf-to-markdown/scripts/markdown_to_pdf.py --stdin "<output.pdf>"

For multi-line content, use a heredoc:

uv run --with pymupdf ~/.kiro/skills/pdf-to-markdown/scripts/markdown_to_pdf.py --stdin "<output.pdf>" <<'EOF'
# Title

Some paragraph with content.

- Bullet point 1
- Bullet point 2

1. Numbered item
2. Another item
EOF

From an existing Markdown file

uv run --with pymupdf ~/.kiro/skills/pdf-to-markdown/scripts/markdown_to_pdf.py "<input.md>" "<output.pdf>"

If you had to create the .md file as an intermediate step, delete it after generating the PDF.

Notes

• Read uses pymupdf4llm for high-quality text extraction preserving structure, tables, and image references.
• Write uses pymupdf (fitz) to generate styled A4 PDFs with headings, bullets, numbered lists, blockquotes, and horizontal rules.
• Dependencies are auto-installed via uv run.
• IMPORTANT: Do NOT create intermediate markdown files if you can pipe content directly via --stdin. If you must create one, always delete it after.