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.