What dependencies are needed for image conversion?

The skill uses the Pillow library to handle image processing, specifically for converting .jp2 files to standard .png files.

Does this skill handle embedded images?

Yes, it extracts all embedded images into a folder named after the PDF and automatically converts JPEG2000 files to PNG for better compatibility.

Does it overwrite existing Markdown files?

You can control this behavior using the --force flag, which allows you to overwrite previously converted files if necessary.

Is the output compatible with Obsidian?

Absolutely. The Markdown files are generated with a structure that is specifically optimized for use within Obsidian and other similar PKM tools.

Can I convert an entire folder of PDFs at once?

Yes, by specifying a root directory, the skill can recursively process all PDF files found within that path.

PDF to Markdown Converter

Name: PDF to Markdown Converter
Author: maitlandmarshall

bymaitlandmarshall

0•

内容管理

Transforms PDF documents into Obsidian-friendly Markdown files while extracting and converting embedded images for streamlined documentation.

This Claude Code Skill automates the process of digitizing PDF assets—such as tabletop RPG campaign notes, character sheets, and handouts—into clean, editable Markdown files. By utilizing the pypdf and Pillow libraries, it not only handles text extraction but also organizes embedded images into dedicated subfolders, automatically converting legacy JPEG2000 formats to modern PNGs. It is particularly useful for users building personal knowledge bases or digital libraries within tools like Obsidian where structured text and organized media are essential for workflow efficiency.

主要功能

010 GitHub stars

02Obsidian-friendly formatting for seamless personal knowledge management

03Bulk conversion of PDF folders to Markdown syntax

04Intelligent conversion of JPEG2000 (.jp2) images to PNG format

05Automatic extraction of embedded images into structured subdirectories

06Command-line flags for recursive processing and forced overwrites

使用场景

01Migrating static PDF documentation into a searchable Markdown-based knowledge base

02Converting TTRPG character sheets and adventure modules into digital campaign wikis

03Extracting high-quality visual assets from embedded PDF layouts for media management

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add maitlandmarshall/voltaire pdf-to-md

For use in Claude.ai and ChatGPT

Download Skill