ai-agent

pdf-to-markdown: Convert PDFs into clean, structured Markdown fast

Name: pdf-to-markdown: Convert PDFs into clean, structured Markdown fast
Author: iamarunbrahma

Extract text from any PDF and get ready‑to‑use Markdown, ideal for founders building documentation, knowledge bases, or RAG pipelines.

From the repo · “Turn PDFs into clean, structured Markdown”

212 stars+2★ this week31 forksPythonGuide quality 9/10 · reviewed Oct 10Updated 9/14/2026100% free · open source

What it does

Convert PDF files into clean and structured Markdown format using the pdf-to-markdown tool

When to use it

•When you need to extract text from PDFs for web content
•When converting academic papers or ebooks to Markdown for easier editing
•When migrating PDF-based documentation to a Markdown-based wiki

Ready-to-paste prompt

python pdf2md.py -i example.pdf -o example.md --title 'Example PDF' --heading-level 2

Heads up: The tool requires the `pdfplumber` and `pyyaml` libraries to be installed, which may require additional dependencies on certain systems

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

✅ Light setup

Installs with a command or two; your AI agent can do it for you.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/pdf-to-markdown && curl -fsSL https://workflowstacks.com/api/skills/pdf-to-markdown/claude-skill -o ~/.claude/skills/pdf-to-markdown/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How pdf-to-markdown: Convert PDFs into clean, structured Markdown fast works

Codeflow

Free to inspect

Pdf-to-markdown: Convert PDFs into clean, structured Markdown fast is a small Python project (~2.2k lines across 23 code files, plus 6 test files). Setup is light: installs like a normal app. Reading the code is optional. Last commit a month ago, MIT license, has a test suite.

Size

Small codebase

~2.2k lines · 23 code files · 18 min skim

Setup

One-command install

Installs like a normal app. Reading the code is optional.

Runs on

Python

No API keys detected

Python 100%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
pdf2md/cli.py
Where the program starts running
3
pyproject.toml
Dependencies and the commands it exposes

What's in each folder

pdf2md/Folder23 files

config/Configuration1 files

tests/Tests — proof it works9 files

READMEHas testsThin docsNo CIMIT licenseUpdated 1 mo ago