extract-slide-text

name	extract-slide-text
description	Extract text from each page of a PDF into a markdown file using pdftotext. Produces slide_ascii.md with a heading, image reference, and extracted text per slide. USE FOR: extract text from PDF slides, get slide text content, PDF to markdown text, slide_ascii.md.
argument-hint	<pdf_path> <output_path> [images_dir]

Extract slide text from PDF

Run the extract_slide_text.py script to extract the text content of each PDF page into a structured markdown file:

uv run .github/skills/extract-slide-text/extract_slide_text.py <pdf_path> <output_path> [images_dir]

Arguments

• pdf_path (required): Path to the PDF file.
• output_path (required): Path to write the output markdown file
• images_dir (optional): Path to the slide images directory. Used to generate correct relative image references. Defaults to slide_images/.

Output format

A markdown file with one section per slide:

## Slide 1

![Slide 1](slide_images/slide_1.png)

\```
Extracted text content from slide 1
\```

## Slide 2

![Slide 2](slide_images/slide_2.png)

\```
Extracted text content from slide 2
\```

Pages with no extractable text (e.g., full-bleed images) show (no extractable text).

Why this matters

PDF text extraction is deterministic — it produces ground-truth slide content without relying on vision models. This prevents misidentification of embedded screenshots or demo captures as actual slide content, a common failure mode when using only image-based slide analysis.

Prerequisites

Poppler utilities must be installed (provides the pdftotext command):

• macOS: brew install poppler
• Ubuntu: apt-get install poppler-utils