pdf-to-markdown

Extract text from PDFs and save clean Markdown beside the source file.

4|2|Updated Jun 2, 2015
One-click install
npx skills add https://github.com/lttr/dotfiles --skill pdf-to-markdown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pdf-to-markdown
Source: https://github.com/lttr/dotfiles/tree/main/claude/skills/pdf-to-markdown
Command: npx skills add https://github.com/lttr/dotfiles --skill pdf-to-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extract text from PDF documents and convert it into clean Markdown, including scanned or image-based PDFs, with output saved alongside the original file.

Core Features & Use Cases

  • Multimodal transcription: Leverage Read/visual transcription to convert pages into text.
  • OCR-friendly formatting: Structure output with headings, lists, and readable formatting.
  • Output location: Markdown file saved next to the source PDF with the same base name.

Quick Start

Use the skill on a PDF to generate a Markdown file in the same directory. For example, on document.pdf, the output will be document.md.

Frequently Asked Questions about pdf-to-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract text from a PDF and convert it to Markdown?▼

Extract text from PDF documents and convert it to clean Markdown by running the Skill on your PDF file. It handles both text-based and scanned PDFs using OCR, outputting a Markdown file with the same base name saved in the same directory as your source PDF.

Can I use this to process scanned PDFs or image-based documents?▼

Yes, this Skill handles scanned and image-based PDFs through OCR-friendly transcription. It extracts text from visually encoded pages and formats the output as structured Markdown with proper headings and lists.

How does the Skill handle large PDF documents?▼

Large documents are processed with chunked extraction and parallel processing to handle page-by-page transcription efficiently. The output Markdown file is saved alongside your source PDF for easy access.

What output formatting does the Markdown conversion include?▼

Converted Markdown includes structured formatting with headings, lists, and readable text layout. The output file uses the same base filename as the source PDF with a .md extension, saved in the same directory.

Do I need to prepare my PDF in any specific way before conversion?▼

No special preparation is required. The Skill works directly on PDF files whether they are text-based, scanned, or image-based documents. Simply run it on your PDF and the Markdown output is generated automatically.

What happens if text extraction fails on certain pages?▼

The Skill includes error checking throughout extraction and processing. It validates the transcription quality and handles OCR challenges, though complex layouts or heavily degraded scans may affect extraction accuracy.