convert-pdf-to-md
Converts PDF (.pdf) documents into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from. Use this skill whenever the user shares, references, or asks about a .pdf file — even if they don''t say "convert" or "markdown" explicitly. This includes requests to "read", "summarize", "review", "extract data from", "compare", or "analyze" a PDF report, paper, invoice, form, contract, or scanned document. Always run the bundled conversion script to produce Markdown first; do not attempt to parse PDF content directly or write ad-hoc extraction code. Also use this
Profile →npx skills add github/awesome-copilot --skill convert-pdf-to-md --agent copilot
Same command for any agent — swap --agent for claude-code, codex, cursor.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Convert PDF to Markdown ## When to use this skill Trigger this skill any time there is a `.pdf` file that needs to be understood or processed — for example, a user attaches a PDF and asks questions about it, wants a summary, wants specific data or tables pulled out, or wants multiple PDFs in a folder processed together. PDF is a layout/print format, not reliably readable as plain text, so always convert it to Markdown first using the script in this skill rather than trying to open or parse the file directly. This skill only supports `.pdf` — that's MarkItDown's only PDF-family format, so there's no legacy format to worry about here (unlike Word's `.doc` or Excel's `.xls`). **Mixed file types:** When the user references a folder or set of documents containing multiple supported file types (`.pdf`, `.docx`, `.xlsx`), this skill handles only `.pdf` files. The agent MUST also invoke the sibling skills in parallel: - `convert-word-to-md` for any `.docx` files - `convert-excel-to-md` for any `.xlsx` files Never process a folder and silently skip a supported file type. All three skills must be invoked together when mixed types are present. ## Setup (once per environment) Before the firs
- When to use this skill
- Setup (once per environment)
- Usage
- Deciding where output goes
- Troubleshooting
What does the convert-pdf-to-md skill do?
Converts PDF (.pdf) documents into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from. Use this skill whenever the user shares, references, or asks about a .pdf file — even if they don''t say "convert" or "markdown" explicitly. This includes requests to "read", "summarize", "review", "extract data from", "compare", or "analyze" a PDF report, paper, invoice, form, contract, or scanned document. Always run the bundled conversion script to produce Markdown first; do not attempt to parse PDF content directly or write ad-hoc extraction code. Also use this
How do I install it?
Run `npx skills add github/awesome-copilot --skill convert-pdf-to-md --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.