
Pdf To Markdown
This converts PDFs to structured Markdown while preserving headings, tables, and lists instead of dumping flat text. It's built on Nutrient's CLI tool and handles both single files and batch directory processing. The batch mode runs conversions in parallel, which matters if you're processing more than a handful of documents. You can optionally extract images too. The main thing to know is it writes output to disk and doesn't auto-load it back into context, which is the right default since converted PDFs can be huge. Free up to 1,000 documents per month, then you need a commercial license.
- skills.sh installs
- 853
- GitHub stars
- 18
- last updated
- Aug 21, 2026
Install
$ npx -y skills add pspdfkit-labs/nutrient-skills --skill pdf-to-markdown --agent claude-codeInstalls into .claude/skills of the current project.
Files
Rules for agents
- Convert each PDF once and save the result. Search the saved file instead of converting it again.
- For a known term, start with a bounded search such as
grep -n -i -C2 "term" file | head. - Use the
queryskill when you do not know the exact wording or a plain search returns too many matches. - Use
pdf-to-textwhen whitespace and column alignment matter more than Markdown structure. - Do not render PDF pages as images to extract selectable text. Use Vision for scans and image-only PDFs.
PDF to Markdown
Convert PDFs to Markdown while preserving headings, tables, lists, and reading order.
Related skills
pdf-to-text— preserves whitespace and column alignment in plain text.query— searches a large converted file and returns only the most relevant passages.
Usage
Set SKILL_DIR to the absolute path of the directory containing this file. Use $SKILL_DIR/bin/pdf-to-markdown in the commands below.
The wrapper downloads the CLI from Nutrient's CDN on first use and stores it in ~/.local/share/nutrient/cli/. It checks for updates every six hours.
Convert one PDF
Sponsors
Details
- Repository
- github.com/pspdfkit-labs/nutrient-skills
- Categories
- AI & Agent Building, Office & Documents
- First seen
- Jun 3, 2026