Skip to content
Skill

Convert PDF to md

Converts PDF (.pdf) documents into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from

Install
Scripts
Python
Platforms
Claude Code, Codex, Cursor
GitHub stars
41.3K
Last commit
1 day ago
License
MIT
Listing updated
today

When your agent uses it

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 skill for batch requests involving a whole folder of PDF documents. IMPORTANT: When the user references a folder or set of documents containing multiple file types (.pdf, .docx, .xlsx), invoke ALL three sibling skills — convert-pdf-to-md, convert-word-to-md, and convert-excel-to-md — so no file type is silently skipped.

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 4 files (21 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

Copy the skill folder to ~/.claude/skills/convert-pdf-to-md to use it in all your projects:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/convert-pdf-to-md &&
cp -R "$tmp/skills/convert-pdf-to-md" ~/.claude/skills/convert-pdf-to-md &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/convert-pdf-to-md inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/convert-pdf-to-md to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/convert-pdf-to-md &&
cp -R "$tmp/skills/convert-pdf-to-md" ~/.agents/skills/convert-pdf-to-md &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/convert-pdf-to-md inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/convert-pdf-to-md to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/convert-pdf-to-md &&
cp -R "$tmp/skills/convert-pdf-to-md" ~/.cursor/skills/convert-pdf-to-md &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/convert-pdf-to-md inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/github/awesome-copilot.git --path skills/convert-pdf-to-md

Or copy the folder to ~/.gemini/skills/convert-pdf-to-md yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/convert-pdf-to-md:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/convert-pdf-to-md &&
cp -R "$tmp/skills/convert-pdf-to-md" ~/.copilot/skills/convert-pdf-to-md &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/convert-pdf-to-md inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/github/awesome-copilot.git

Then copy awesome-copilot/skills/convert-pdf-to-md into your agent's skills folder as convert-pdf-to-md. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Convert PDF to md FAQ

How do I install Convert PDF to md in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/convert-pdf-to-md to use it in all your projects, or to .claude/skills/convert-pdf-to-md in one project.

Does Convert PDF to md run scripts?

Yes. It runs Python scripts. No network calls were found in its scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Convert PDF to md?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

More from github/awesome-copilot

  1. Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.

    • Open source
    • 41.3K GitHub stars
  2. Review pull requests for repository fit, meaningful value, trustworthy provenance, differentiation, and maintainability in awesome-copilot.

    • Open source
    • 41.3K GitHub stars
    • Developer tools
  3. Create or register a canvas extension in the awesome-copilot repository

    • Open source
    • 41.3K GitHub stars
  4. Use this skill when the user explicitly asks to map, document, or onboard into an existing codebase

    • Open source
    • 41.3K GitHub stars
  5. Run the AgentRC readiness assessment on the current repository and produce a static HTML dashboard at reports/index.html

    • Open source
    • 41.3K GitHub stars
    • Developer tools