pdf-to-md — pdf to markdown conversion pdf-to-md, voltaire, community, pdf to markdown conversion, ide skills, obsidian markdown conversion, python pdf conversion, pdf-to-md install, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Perfect for Document Analysis Agents needing seamless PDF to Markdown conversion capabilities. pdf-to-md is a skill that converts PDF files to Markdown format, optionally extracting embedded images into a sibling folder for easy access and organization.

Features

Converts PDF files to Obsidian-friendly Markdown using Python 3
Extracts embedded images into a sibling folder
Supports conversion of single PDF files or all PDFs under a specified root directory
Utilizes the `pdf_to_md.py` script for conversion
Allows for forced conversion using the `--force` command

# Core Topics

maitlandmarshall maitlandmarshall
[0]
[0]
Updated: 3/8/2026

Agent Capability Analysis

The pdf-to-md skill by maitlandmarshall is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance. Optimized for pdf to markdown conversion, obsidian markdown conversion, python pdf conversion.

Ideal Agent Persona

Perfect for Document Analysis Agents needing seamless PDF to Markdown conversion capabilities.

Core Value

Empowers agents to convert campaign PDFs into Obsidian-friendly Markdown, extracting embedded images into a sibling folder using Python scripts, enabling efficient document processing and analysis with protocols like PDF parsing and Markdown rendering.

Capabilities Granted for pdf-to-md

Converting character sheets to Markdown
Extracting images from campaign PDFs
Automating PDF to Markdown conversions for session exports and handouts

! Prerequisites & Limits

  • Requires Python 3 execution environment
  • Limited to PDF files with extractable text and images
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

pdf-to-md

Install pdf-to-md, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

PDF → Markdown (and Images)

Use this skill to convert campaign PDFs (character sheets, session exports, handouts) into Obsidian-friendly Markdown, optionally extracting embedded images into a sibling folder.

Quickstart

Convert a single PDF:

  • python3 .codex/skills/pdf-to-md/scripts/pdf_to_md.py --root "Voltaire/Character Sheets" --force

Convert all PDFs under Adventures/:

  • python3 .codex/skills/pdf-to-md/scripts/pdf_to_md.py --root Adventures --force

Behavior

  • Writes <pdf>.md next to the PDF.
  • Extracts embedded images into a folder named after the PDF (e.g. Foo.pdfFoo/).
  • Converts embedded JPEG2000 (.jp2) images to .png when possible (Pillow).

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is pdf-to-md?

Perfect for Document Analysis Agents needing seamless PDF to Markdown conversion capabilities. pdf-to-md is a skill that converts PDF files to Markdown format, optionally extracting embedded images into a sibling folder for easy access and organization.

How do I install pdf-to-md?

Run the command: npx killer-skills add maitlandmarshall/voltaire/pdf-to-md. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for pdf-to-md?

Key use cases include: Converting character sheets to Markdown, Extracting images from campaign PDFs, Automating PDF to Markdown conversions for session exports and handouts.

Which IDEs are compatible with pdf-to-md?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for pdf-to-md?

Requires Python 3 execution environment. Limited to PDF files with extractable text and images.

How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add maitlandmarshall/voltaire/pdf-to-md. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use pdf-to-md immediately in the current project.

Related Skills

Looking for an alternative to pdf-to-md or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

149.6k
0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

138.4k
0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
AI