How to Convert PDF to Markdown

Converting PDF files to markdown is one of the most common document conversion tasks for developers, researchers, and content creators. Whether you're building a RAG system, migrating documentation, or just want your PDFs in a more editable format, this guide covers everything you need to know.

Quick Answer: The Easiest Way

The fastest way to convert PDF to markdown is using a browser-based converter like Craft Markdown's free PDF to Markdown tool. No installation, no code, no uploads to servers—just drag, drop, and get clean markdown instantly.

For those who prefer code or need automation, we'll cover command-line tools like Pandoc later in this guide.

---

Why Convert PDF to Markdown?

Before diving into the how, let's understand why markdown is the ideal target format:

1. AI and LLM Readiness

Markdown is the best format for feeding content to ChatGPT, Claude, or RAG systems:

• Token efficiency: Markdown uses 30-50% fewer tokens than HTML or JSON
• Better embeddings: Clean text produces higher-quality vector embeddings
• Improved retrieval: RAG systems show up to 35% better accuracy with markdown vs raw PDF text

2. Future-Proof and Portable

• Plain text format that will never become obsolete
• Works with any text editor
• Version control friendly (Git, SVN, etc.)
• Platform independent

3. Easy to Edit and Search

• Edit in Obsidian, Typora, VS Code, or any markdown editor
• Full-text search with grep, ripgrep, or built-in tools
• No proprietary software required

4. Structure Preservation

• Headings become # headers
• Tables convert to markdown tables
• Lists maintain hierarchy
• Links remain clickable

---

Method 1: Browser-Based Converter (Recommended)

Best for: Most users, one-time conversions, privacy-conscious workflows

Step 1: Open the Converter

Go to Craft Markdown's PDF to Markdown Converter. No signup required.

Step 2: Drop Your PDF

Drag and drop your PDF file onto the converter interface. Your file is processed entirely in your browser—nothing gets uploaded to a server.

Step 3: Get Your Markdown

• Preview the markdown output to check quality
• Copy directly to clipboard for quick use
• Download as a .md file for later

Why This Method Wins

✅ Zero setup — Works immediately, no installation
✅ 100% private — Files never leave your browser
✅ Fast — Instant results
✅ Free — No limits, no signup
✅ Clean output — Optimized for AI/LLM use

Try it now →

---

Method 2: Pandoc (Command Line)

Best for: Developers, automation, batch conversions

What is Pandoc?

Pandoc is a powerful command-line document converter that supports 50+ formats. It's the Swiss Army knife of document conversion, but requires technical setup.

Installation

macOS:

brew install pandoc

Ubuntu/Debian:

sudo apt install pandoc

Windows:
Download from pandoc.org

Basic Conversion

pandoc input.pdf -o output.md

Advanced Options

# Specify PDF reader
pandoc input.pdf --pdf-engine=xelatex -o output.md

# Extract text only (no formatting)
pandoc input.pdf --extract-media=./images -o output.md

Pandoc Pros & Cons

Pros:

• Powerful and flexible
• Scriptable for automation
• Free and open-source
• Supports 50+ formats

Cons:

• Requires installation
• Command-line only (not user-friendly)
• PDF conversion quality varies
• Complex syntax for advanced features
• No privacy advantage (local processing)

---

Method 3: Python with Libraries

Best for: Developers building custom pipelines, automation

Using pdfplumber + markdownify

import pdfplumber
from markdownify import markdownify as md

# Extract text from PDF
with pdfplumber.open("input.pdf") as pdf:
    text = ""
    for page in pdf.pages:
        text += page.extract_text()

# Convert to markdown (basic)
markdown_output = md(text)

# Save to file
with open("output.md", "w") as f:
    f.write(markdown_output)

Using PyMuPDF (fitz)

import fitz  # PyMuPDF

doc = fitz.open("input.pdf")
markdown = ""

for page in doc:
    markdown += page.get_text()

with open("output.md", "w") as f:
    f.write(markdown)

Python Method Pros & Cons

Pros:

• Full control over extraction
• Can customize output format
• Good for batch processing
• Integrates with data pipelines

Cons:

• Requires Python knowledge
• Need to handle formatting manually
• Table extraction is challenging
• More code to maintain

---

Method 4: Online Converters (Compare)

Craft Markdown vs pdf2md.morethan.io

Feature	Craft Markdown	pdf2md.morethan.io
Privacy	✅ Browser-based	❌ Server upload
AI-Optimized	✅ RAG-ready	❌ Generic output
Multi-format support	✅ 9+ formats	❌ PDF only
Free	✅ Unlimited	✅ Unlimited
Table handling	✅ Excellent	⚠️ Basic
Ads	✅ None	❌ Yes

Verdict: If privacy matters to you, choose Craft Markdown. If you need multi-format support, Craft Markdown is the only option.

Convert PDF to Markdown Free →

---

Best Practices for PDF to Markdown Conversion

1. Use Digital-Native PDFs

PDFs created from Word, Google Docs, or LaTeX convert better than scanned PDFs. If your PDF has selectable text (you can highlight it), you're good to go.

2. Handle Scanned PDFs Carefully

Scanned PDFs require OCR (Optical Character Recognition):

• Quality varies based on scan resolution
• Expect some errors in text extraction
• Consider using Adobe Acrobat or Tesseract OCR first

3. Clean Up After Conversion

Even the best converters may need minor cleanup:

• Check table formatting
• Verify heading levels
• Fix broken links
• Adjust list indentation

4. Optimize for AI/LLM Use

If you're converting for RAG systems or LLM training:

• Remove headers and footers
• Clean up page numbers
• Remove artifacts from PDF formatting
• Ensure heading hierarchy is correct

5. Preserve Document Structure

• Keep heading hierarchy (#, ##, ###)
• Maintain table structure
• Preserve list formatting
• Keep internal links

---

Common Issues and Solutions

Issue: "My PDF comes out as gibberish"

Cause: The PDF likely contains scanned images, not selectable text.

Solution:

1. Check if text is selectable in the PDF
2. If not, use OCR software first (Adobe Acrobat, Tesseract)
3. Or try a different PDF export from the source document

Issue: "Tables aren't converting properly"

Cause: Complex table layouts (merged cells, nested tables) are challenging.

Solution:

1. Use Craft Markdown's converter which has better table detection
2. Manually clean up tables in markdown
3. For critical tables, recreate manually

Issue: "Images aren't included"

Cause: Markdown converters extract text and structure, not embedded images.

Solution:

1. Extract images separately from the PDF
2. Save images to a folder
3. Reference images in markdown: ![Alt text](./images/image.png)

Issue: "Formatting is lost"

Cause: Markdown is intentionally simple and doesn't support complex formatting.

Solution:

• Bold and italic convert fine
• Colors, fonts, and layouts are stripped (this is a feature for clean text)
• For rich formatting, consider HTML instead of markdown

---

Use Cases: When to Convert PDF to Markdown

1. Building RAG Systems

Convert PDFs to markdown before ingesting into vector databases:

# Example: PDF → Markdown → Embeddings
markdown_text = convert_pdf_to_markdown("research_paper.pdf")
chunks = split_into_chunks(markdown_text)
embeddings = create_embeddings(chunks)
store_in_vector_db(embeddings)

Markdown produces better embeddings than raw PDF text because:

• No PDF artifacts
• Clean structure
• Consistent formatting

2. Migrating Documentation

Moving from PDF-based docs to markdown-based systems (MkDocs, Docusaurus, Hugo):

• Convert all PDFs to markdown
• Add frontmatter and metadata
• Deploy as static site
• Enable search and version control

3. Research and Note-Taking

Convert research papers and ebooks to markdown for Obsidian, Roam Research, or Notion:

• Full-text search across all papers
• Link between notes
• Annotate and highlight
• Build a personal knowledge base

4. LLM Training Data Preparation

Extract text from PDF books and papers for LLM fine-tuning:

• Clean, structured text
• Preserves document hierarchy
• Removes formatting noise
• Ready for tokenization

5. Content Archival

Future-proof your PDFs by converting to markdown:

• Plain text lasts forever
• No proprietary format lock-in
• Git version control
• Easy migration to new tools

---

Comparison: Which Method Should You Use?

Method	Best For	Difficulty	Privacy	Quality
Craft Markdown	Most users, one-time conversion	⭐ Easy	✅ Best	⭐⭐⭐⭐⭐
Pandoc	Developers, automation	⭐⭐⭐ Hard	✅ Good	⭐⭐⭐⭐
Python	Custom pipelines, batch jobs	⭐⭐⭐⭐ Expert	✅ Good	⭐⭐⭐
Other online tools	Quick conversion (less privacy)	⭐ Easy	❌ Poor	⭐⭐⭐

Our recommendation: Start with Craft Markdown for 99% of use cases. Only use Pandoc or Python if you need scripting or have very specific requirements.

---

Frequently Asked Questions

Can I convert scanned PDFs to markdown?

Yes, but with limitations. Scanned PDFs are images, so conversion quality depends on OCR accuracy. For best results, use high-resolution scans with clear fonts. Try our converter which handles both digital and scanned PDFs.

Is PDF to markdown conversion free?

Yes! Craft Markdown's converter is completely free with no limits. Open-source tools like Pandoc are also free.

How do I preserve formatting when converting PDF to markdown?

Markdown intentionally has limited formatting (bold, italic, headers, lists, tables). Complex formatting like colors, fonts, and layouts won't convert. This is a feature—clean markdown is better for AI, searchability, and long-term archival.

What's the best tool for converting PDF to markdown?

For most users, Craft Markdown's browser-based converter is the best choice: it's free, private (no uploads), produces clean AI-ready output, and requires no installation. For developers who need automation, Pandoc is the best command-line option.

Can I batch convert multiple PDFs to markdown?

Yes, using Pandoc or Python scripts. For browser-based conversion, you can convert PDFs one at a time using our converter.

Will this work for PDFs with images?

Text and structure convert well. Images are referenced but not embedded. For full image extraction, you'll need to export images separately and link them in the markdown.

---

Next Steps

Ready to convert your PDFs to clean, AI-ready markdown?

→ Try the Free PDF to Markdown Converter

No signup required. Privacy-first. Instant results.

Want to learn more?

• PDF to Markdown for RAG Systems
• Best PDF to Markdown Converters Compared
• Why LLMs Love Markdown — The Best Format for AI Processing

---

Summary

Converting PDF to markdown is simple with the right tool:

1. For most users: Use Craft Markdown's free online converter
2. For developers: Use Pandoc or Python scripts
3. For privacy: Choose browser-based tools (no server uploads)
4. For AI use cases: Markdown is the best format for RAG, LLM training, and ChatGPT

The key is choosing clean, structured markdown output optimized for your use case—whether that's AI/ML, documentation, or personal knowledge management.

Convert your first PDF now → Free PDF to Markdown Converter