pdf-to-markdown

Installation
SKILL.md

PDF to Markdown

Convert PDFs into structured, semantic Markdown that preserves the document's logical structure — headings, tables, lists, and reading order — rather than producing flat text. This is significantly higher quality than reading a PDF directly with the read tool, which only extracts raw text without structure.

Usage

Before running any commands, set SKILL_DIR to the absolute path of the directory containing this SKILL.md file. Use $SKILL_DIR/bin/pdf-to-markdown in all commands below.

The $SKILL_DIR/bin/pdf-to-markdown wrapper automatically installs the platform-specific binary into ~/.local/share/nutrient/cli/ from the CDN. It caches the binary and only checks for updates every 6 hours, so subsequent runs are fast.

Single file

$SKILL_DIR/bin/pdf-to-markdown INPUT.pdf OUTPUT.md

If OUTPUT.md is omitted, the converter writes the Markdown to stdout instead.

Batch directory (2+ files)

Related skills
Installs
128
GitHub Stars
11
First Seen
Apr 1, 2026