One-click install
npx skills add https://github.com/jeff-hamm/ai-tools --skill pdf-to-md-jeff-hamm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-to-md
Source: https://github.com/jeff-hamm/ai-tools/tree/main/src/skills/pdf-to-md
Command: npx skills add https://github.com/jeff-hamm/ai-tools --skill pdf-to-md-jeff-hamm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert PDF documents into clean, readable Markdown to make editing, sharing, and archiving easier.

Core Features & Use Cases

  • PDF to Markdown conversion: Extracts text from PDFs and outputs structured Markdown with readable formatting.
  • Text cleanup: Removes headers/footers, fixes hyphenation, and joins wrapped lines for coherence.
  • Use Case: Ideal for converting reports, manuals, and contracts into editable docs for knowledge bases or documentation.

Quick Start

Run the Python snippet to convert a target PDF to Markdown and save the result as an .md file.

Frequently Asked Questions about pdf-to-md

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

FAQPage Schema
How do I convert a text-based PDF to Markdown for editing?

To convert a text-based PDF to Markdown, this Skill uses pymupdf4llm to extract text, perform cleanup passes removing headers and footers, and output a structured Markdown file for easy editing.

Can I remove headers and footers when extracting text from a PDF?

Yes, you can remove headers and footers during PDF text extraction. The Skill applies cleanup passes that strip headers and footers, fix hyphenation, and join wrapped lines to produce coherent Markdown.

What is the best way to turn PDF reports and contracts into an editable knowledge base?

The best way to turn PDF reports and contracts into an editable knowledge base is converting them to Markdown. This Skill extracts structured text, removes repeated headers, and joins paragraphs for clean documentation.

Does the PDF to Markdown conversion process fix broken paragraphs and hyphenation?

Yes, the PDF to Markdown conversion process fixes broken paragraphs and hyphenation. The Skill joins wrapped lines and corrects hyphenation issues during its text cleanup passes to ensure readable output.

Are there limitations when converting scanned PDFs to Markdown text?

Yes, there are limitations when converting scanned PDFs to Markdown text. This Skill applies to text-based PDFs like reports and contracts, meaning it requires embedded text rather than scanned images for extraction.