pdf2md - Automated PDF to Markdown Converter

One command to convert any PDF to Markdown with images and validation.

---

🚀 Quick Start

1. Install

./install.sh

2. Use

pdf2md your-file.pdf

3. Done!

your-file_converted.md
your-file_converted_images/

---

📖 Documentation

• OVERVIEW.txt - Quick overview (start here)
• TOOL_SUMMARY.md - Complete guide
• INSTALL.md - Installation instructions
• USAGE_EXAMPLES.md - 20+ examples
• QUICKREF.md - Quick reference card
• pdf2md_README.md - Full README

---

✨ Features

✅ Fully automated - one command
✅ Smart image placement
✅ Built-in validation (7 tests)
✅ Beautiful terminal output
✅ Production ready

---

💻 Basic Usage

# Convert any PDF
pdf2md document.pdf

# Custom output name
pdf2md book.pdf --output my-book.md

# Verbose mode
pdf2md document.pdf --verbose

# Batch convert
for pdf in *.pdf; do pdf2md "$pdf"; done

---

📦 What's Included

pdf2md_tool/
├── pdf2md              ← Main tool (executable)
├── install.sh          ← Installation script
├── README.md           ← This file
├── OVERVIEW.txt        ← Quick overview
├── TOOL_SUMMARY.md     ← Complete documentation
├── INSTALL.md          ← Installation guide
├── USAGE_EXAMPLES.md   ← Usage examples
├── QUICKREF.md         ← Quick reference
└── pdf2md_README.md    ← Full README

---

🎯 Installation Options

Global (recommended):

./install.sh

User install (no sudo):

./install.sh --user

Direct use (no install):

./pdf2md your-file.pdf

---

⚙️ Requirements

• Python 3.6+
• markitdown: pip3 install markitdown
• poppler: brew install poppler

---

Ready to convert! 🚀

./install.sh
pdf2md your-file.pdf