Guide

Files to Markdown

What works best for PDF, DOCX, JPG, and PNG conversions, plus what to review before publishing.

Files to Markdown#

mdcraft converts PDF, DOCX, JPG, and PNG files into editable Markdown.

Best-fit inputs#

DOCX#

Usually the most reliable source for structure-heavy content such as:

  • headings
  • lists
  • basic tables
  • body text with clear hierarchy

PDF#

Best for text-first documents such as:

  • reports
  • guides
  • whitepapers
  • notes and reference docs

JPG and PNG#

Useful for:

  • screenshots
  • scanned pages
  • photographed documents with simple layout

What to expect#

  • Text-first files usually need less cleanup.
  • Scanned or layout-heavy files may need manual review.
  • Tables, code blocks, and complex layouts can require touch-ups after conversion.
  • Charts, diagrams, and visually dense designs are harder to reconstruct as clean Markdown.

Review before publishing#

Files to Markdown is designed as a review-first workflow.

Check these areas before you copy or export the result:

  • heading levels
  • list nesting
  • table formatting
  • code fences
  • OCR mistakes in scanned files

Practical advice#

  • Prefer DOCX over PDF when you can choose the source format.
  • Prefer text-first PDFs over image-only scans.
  • Break very messy or visually complex source material into smaller, easier-to-review sections when possible.