PDFs are everywhere, but they’re terrible for editing, searching, version control, or reposting. Markdown is the opposite — flexible, editable, portable, and renders anywhere.
Converting PDF → Markdown is a common need. Here’s how to do it.
When you need PDF → Markdown
Three good reasons:
- You’re moving to a Markdown-based tool. Notion, Obsidian, Hugo, Jekyll, GitHub all want Markdown.
- You want to edit a PDF’s content. PDFs are read-only. Markdown is plain text you can edit freely.
- You want a version-controlled archive. Put Markdown in Git. Get history, branching, backups.
Method 1: Use a PDF-to-Markdown tool (fastest)
For most PDFs, a dedicated tool is the right move:
→ Try our free PDF to Markdown tool
What it does:
- Upload any PDF (text-based, not scanned)
- We parse it in your browser using Mozilla’s pdf.js library
- We detect headings by font size and convert structure to Markdown
- Download as .md or copy to clipboard
The whole thing takes seconds for a typical PDF. The file never leaves your device — all processing happens in your browser.
What works:
- Text-based PDFs (most modern PDFs)
- Heading detection (uses font size)
- Paragraph breaks
- Basic structure
What doesn’t work (yet):
- Scanned PDFs (use OCR instead)
- Perfect table extraction (basic support only)
- Embedded images (not preserved)
Method 2: Manual conversion (for tricky PDFs)
For complex PDFs (academic papers with formulas, multi-column layouts, complex tables), tools can only do so much. You may need manual cleanup.
A common workflow:
- Run the PDF through our tool to get the basic Markdown
- Open the .md file in your text editor
- Fix the structure that the tool missed:
- Heading levels (H1 vs H2 vs H3)
- Table formatting
- Lists that got concatenated
- Save and use
For very complex documents (textbooks, scientific papers), you may want a more powerful tool like Adobe Acrobat’s export feature, Mathpix for equations, or Pandoc for command-line conversion.
What about scanned PDFs?
Scanned PDFs are images of text — they’re not actually text inside the PDF. To convert them, you need OCR (optical character recognition).
Options:
- Adobe Acrobat — Paid, but very accurate
- Google Drive — Free. Upload a PDF, open with Google Docs, export as text
- Microsoft Lens — Mobile app, free
- Online OCR services — Various, quality varies
For best results with scanned PDFs, we recommend a dedicated OCR tool rather than a PDF-to-Markdown tool.
How to handle tables in Markdown
Markdown has basic table support:
| Column 1 | Column 2 |
|----------|----------|
| Cell A | Cell B |
| Cell C | Cell D |Our tool attempts to detect tables, but complex tables (merged cells, nested headers) often need manual cleanup. Common issues:
- Tables without borders → may not be detected as tables
- Multi-row headers → may be flattened
- Nested tables → may be flattened to a single table
For most business documents, the basic detection is enough. For academic papers with complex tables, plan on some manual cleanup.
A real example
Let’s say you have a 20-page PDF report you need to put in Obsidian.
Step 1: Run it through our tool. Get a .md file with all the text and detected headings.
Step 2: Open the .md file in VS Code or Obsidian.
Step 3: Spot-check the structure:
- Are the headings in the right hierarchy? (H1, H2, H3)
- Are the paragraphs separated properly?
- Did any tables break?
Step 4: Fix any issues manually. Usually this is 5-10 minutes of work, not hours.
Step 5: Save. The Markdown is now searchable, editable, and version-controlled in your Obsidian vault.
Total time: 15-20 minutes for a 20-page PDF. Mostly automated.
Common problems (and fixes)
“The output is missing text.”
The PDF might have text rendered as images (scanned or image-based). Solution: use OCR first.
“Headings are wrong.”
The PDF might use non-standard fonts or formatting. Solution: fix manually in your text editor.
“Tables look weird.”
The PDF table structure is complex. Solution: manual cleanup, or accept the simplified output.
“The output has weird characters.”
Encoding issues with non-English text. Solution: try a different tool, or specify the source language if the tool supports it.
Try it now
Pick a PDF you’ve been meaning to convert:
- Upload it to our PDF to Markdown tool
- Download the .md file
- Drop it in your Markdown editor (Obsidian, VS Code, anywhere)
- Edit as needed
Total time: 1 minute for a typical PDF.
Related tools: PDF to Markdown · Notion to Markdown · Medium Reader · Substack to PDF