pdf2md-study

English | 한국어

Convert papers and lecture slides (PDF) into study-ready Markdown for LLMs — equations and code kept as images, logos and references stripped.

Built on Docling.

Why

Uploading a PDF to an LLM sends the text and an image of every page. The Markdown is several times smaller and keeps what matters for studying. Each conversion prints an estimate like these:

Features

• Equations and code are cropped as images, so nothing is lost to recognition errors.
• Logos and decorations repeated across pages are removed.
• The references section is removed.
• Slides get a [p.N] label on each page.
• Images are named by page: p04_1.png, p05_eq1.png, p30_code1.png.

Get started

With uv installed:

uv tool install pdf2md-study
pdf2md-study paper.pdf

Or with Docker, with Docling's models included:

docker run --rm --user "$(id -u):$(id -g)" -v "$PWD:/data" ghcr.io/inhyunseo/pdf2md-study paper.pdf

paper.md and paper_artifacts/ appear next to the PDF.

• Quickstart: step by step on Ubuntu, WSL2, macOS, and Windows
• Usage: options, output, and tips for sending to an LLM

Development

git clone https://github.com/InHyunseo/pdf2md-study.git
cd pdf2md-study
uv sync
uv run pytest
uv run ruff check

Pull requests run lint and tests on Ubuntu, Windows, and macOS.

License

MIT