pdf2-md

Convert academic PDFs into structured Markdown documents using LLM vision.

5|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/yuhaoliu7456/pdf2md-skill --skill pdf2-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf2-md
Source: https://github.com/yuhaoliu7456/pdf2md-skill/tree/main
Command: npx skills add https://github.com/yuhaoliu7456/pdf2md-skill --skill pdf2-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdftoppm, PyMuPDF, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables the conversion of academic PDF papers into clean, well-structured Markdown documents, preserving equations, tables, and figures for easy editing and sharing.

Core Features & Use Cases

  • Accurate Content Reconstruction: Uses LLM vision to extract text, math, figures, and tables directly from PDF images, ignoring layout heuristics.
  • Workflow Automation: Automates rendering PDF pages to high-quality images and integrating the content into a coherent Markdown file, suitable for research summaries, lecture notes, or publication preparation.
  • Use Case: Researchers can upload scanned or digital PDFs of scientific papers to quickly generate editable Markdown versions suitable for collaborative editing or knowledge dissemination.

Quick Start

Ask the AI to convert a specific PDF document into Markdown text for review or editing.

Frequently Asked Questions about pdf2-md

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

FAQPage Schema
How do I convert academic PDFs into editable Markdown?

To convert academic PDFs into Markdown, this Skill renders PDF pages as images and uses LLM vision to extract content, preserving equations and tables for editable research notes.

What is the best way to extract equations and tables from a scientific paper?

The best way to extract equations and tables from a scientific paper is using LLM vision extraction on rendered PDF images, bypassing layout heuristics to accurately capture complex structures.

Do I need an AI model with vision capabilities to extract figures from PDFs?

Yes, you need an AI model with vision capabilities to accurately extract figures, tables, and math equations from the rendered PDF page images during the Markdown conversion process.

Does converting PDFs to Markdown work with scanned documents?

Yes, PDF to Markdown conversion works with scanned documents because the process relies on LLM vision extraction from page images rather than parsing underlying digital text layers.

What dependencies are required to render PDF pages as images for extraction?

To render PDF pages as images for extraction, you need pdftoppm and PyMuPDF installed in your environment to facilitate the high-quality image rendering required for LLM vision processing.

Why does PDF to Markdown conversion use image rendering instead of direct text parsing?

PDF to Markdown conversion uses image rendering because LLM vision extraction ignores flawed layout heuristics, ensuring accurate reconstruction of complex scientific figures and equations.