Pandoc is the most powerful document converter in existence. It supports 50+ formats, offers deep customization through templates and Lua filters, and has been the standard for document conversion since 2006. It's free, open-source, and used by thousands of developers, academics, and documentation teams worldwide.
Craft Markdown is a browser-based converter that turns documents into clean markdown with a drag-and-drop interface. No installation, no terminal, no configuration. It handles 9+ input formats and produces AI-optimized markdown output — all in your browser, with complete privacy.
Both tools process files locally. Both produce quality output. But they're built for fundamentally different users and workflows. This comparison helps you decide which one to use — or whether to use both.
Quick Comparison
| Feature | Craft Markdown | Pandoc |
|---|---|---|
| Interface | Browser — drag and drop | Command-line terminal |
| Installation | None — works in any browser | Requires installation + dependencies |
| Learning curve | Zero — drag, drop, done | Moderate to steep |
| Time to first conversion | 3 seconds (open page, drop file) | 10-30 minutes (install, learn syntax) |
| Privacy | Browser-based — files stay local | Local processing — files stay local |
| Input formats | 9+ (PDF, DOCX, HTML, CSV, JSON, XML, Excel, TXT, RTF) | 40+ input formats |
| Output formats | Markdown only | 50+ (Markdown, PDF, HTML, DOCX, EPUB, LaTeX, and more) |
| Batch processing | Multi-file drop (manual) | Full scripting and automation |
| Customization | Default optimized output | Extensive (templates, Lua filters, variables) |
| AI-optimized output | Yes — designed for LLM/RAG workflows | Possible with configuration |
| Visual preview | Yes — see output before downloading | No — output goes to a file |
| CSV/JSON/Excel support | Yes — native data format handling | No CSV/JSON/Excel support |
| Citations and bibliography | No | Yes (Citeproc, BibTeX, CSL) |
| Cost | Free | Free (open-source) |
| Best for | Most users, quick conversions, AI workflows | Developers, automation, academic publishing |
Bottom line: Craft Markdown is the better choice for most users who want quick, private, no-setup conversion to markdown. Pandoc is the better choice for developers and power users who need maximum flexibility, batch automation, non-markdown output, or academic features.
Two Fundamentally Different Approaches
Craft Markdown: The Browser Approach
Craft Markdown converts documents to markdown directly in your web browser:
- Open the website
- Drag and drop your file
- See the clean markdown output instantly
- Copy to clipboard or download
No installation. No terminal. No configuration. No account. No learning curve. It works exactly like you'd expect a modern web tool to work — because it is one.
Under the hood, all processing happens via JavaScript in your browser. Your files are never uploaded to any server. This isn't a privacy policy — it's an architectural decision. There is no server-side processing code. The file goes from your disk to your browser's memory to the conversion engine to your screen, and nowhere else.
Pandoc: The Command-Line Approach
Pandoc is a command-line application written in Haskell. It's the Swiss Army knife of document conversion:
pandoc document.pdf -f pdf -t markdown -o output.md
pandoc report.docx -t gfm -o report.md
pandoc article.html -f html -t markdown_strict -o article.md
It's installed locally, runs in your terminal, and can be scripted for batch processing and automation. It supports over 50 input and output formats, handles citations and bibliographies, and offers deep customization through templates and Lua filters.
Pandoc is excellent. It's also complex. It requires installation, assumes terminal comfort, and has a learning curve that ranges from "moderate" (basic conversions) to "steep" (custom templates, filters, and academic workflows).
When Craft Markdown Wins
1. Zero Setup Required
Craft Markdown: Open browser → drop file → done. Works on any device with a modern browser. Nothing to install, configure, update, or maintain.
Pandoc: Install Pandoc (varies by OS and package manager). For PDF support, install a LaTeX distribution (500MB+) or wkhtmltopdf. Learn the command syntax. Configure output options. Deal with dependency conflicts on some systems.
For someone who needs to convert a document right now — a contract, a report, a PDF for a meeting in 10 minutes — Craft Markdown is ready in 3 seconds. Pandoc setup takes 10-30 minutes, longer on Windows or if you need PDF output.
2. No Technical Skills Needed
Craft Markdown: Anyone can use it. Drag a file, get markdown. The interface is self-explanatory. There are no commands to memorize, no flags to learn, no error messages to decode.
Pandoc: Requires terminal/command-line comfort. The basic syntax is straightforward (pandoc input -t markdown -o output), but real-world use quickly introduces format-specific flags, filter options, metadata injection, and template configuration.
If you're recommending a conversion tool to a non-technical colleague — a marketing manager, a lawyer, a project manager, a researcher — Craft Markdown is the answer. You can't casually suggest Pandoc to someone who has never opened a terminal.
3. AI-Optimized Output
Craft Markdown: Output is designed for AI and LLM workflows from the ground up. Clean, token-efficient markdown with preserved heading hierarchy that's optimized for RAG chunking, ChatGPT conversations, Claude Projects, and LLM training data preparation.
Pandoc: Default output is good but not specifically optimized for AI consumption. Pandoc can produce clean markdown, but getting the ideal output for LLM workflows requires understanding which flags to use (--wrap=none, --markdown-headings=atx, --strip-comments, etc.) and potentially writing custom filters.
For users preparing documents for AI assistants or building RAG pipelines, Craft Markdown produces the right output by default. With Pandoc, you need to know what "right" means and how to configure it.
For a deeper understanding of why markdown format matters for AI, see our guide on why LLMs love markdown.
4. Visual Preview
Craft Markdown: See the markdown output immediately in your browser. Verify that tables, headings, and formatting converted correctly before copying or downloading. If the result isn't right, drop another file — the feedback loop is instant.
Pandoc: Output goes to a file. You need to open the file in a separate application to review it. Iteration requires re-running the command, checking the output, adjusting flags, and repeating.
5. Data Format Support
Craft Markdown: Handles CSV, JSON, XML, and Excel files natively. Drop a spreadsheet and get a markdown table. Drop a JSON file and get readable markdown.
Pandoc: Does not support CSV, JSON, or Excel as input formats. These aren't document formats in Pandoc's model — they're data formats. To convert a CSV to a markdown table with Pandoc, you'd need to write a custom reader or preprocess the data.
When Pandoc Wins
1. Output Format Flexibility
Pandoc supports 50+ output formats:
- Markdown → PDF (via LaTeX, wkhtmltopdf, or Chromium)
- Markdown → DOCX (Microsoft Word)
- Markdown → HTML (standalone pages or fragments)
- Markdown → EPUB (ebook publishing)
- Markdown → LaTeX (academic publishing)
- Markdown → PPTX (PowerPoint presentations)
- Markdown → ODT (LibreOffice)
- Markdown → RST (reStructuredText)
- Markdown → AsciiDoc, MediaWiki, Textile, DocBook, JATS, TEI, and many more
Craft Markdown converts files to markdown only. If you need to go from markdown to PDF, from DOCX to HTML, or from markdown to EPUB, Pandoc is the tool.
2. Batch Processing and Automation
Pandoc can be scripted for industrial-scale conversion:
# Convert every PDF in a folder
for file in documents/*.pdf; do
pandoc "$file" -t markdown -o "output/$(basename "$file" .pdf).md"
done
# CI/CD pipeline step: rebuild all docs
pandoc docs/manual.md -o dist/manual.pdf --template=custom.tex
pandoc docs/manual.md -o dist/manual.html --template=custom.html
pandoc docs/manual.md -o dist/manual.epub --metadata title="User Manual"
This converts hundreds of files unattended. It integrates into CI/CD pipelines, documentation build systems, and scheduled automation. Craft Markdown is manual — you drop files individually (multiple files at once is supported, but it's still interactive).
For converting 5 files, Craft Markdown is faster. For converting 500 files, Pandoc is the only option.
3. Deep Customization
Pandoc offers fine-grained control over every aspect of conversion:
- Custom templates for any output format — control the exact HTML, LaTeX, or DOCX structure
- Lua filters for programmatic content transformation — modify the document AST during conversion
- Metadata injection — add title, author, date, and custom variables
- Bibliography support — Citeproc engine with BibTeX, CSL, and cross-references
- Custom readers and writers — define entirely new input/output formats in Lua
- Variables and conditional logic — template logic for dynamic content
If you need your markdown output to follow a specific template, transform content during conversion, or inject metadata automatically, Pandoc's system is unmatched.
4. Academic and Publishing Workflows
Pandoc is the gold standard for academic document production:
- Citations — BibTeX/CSL citation support with thousands of citation styles
- Cross-references — Numbered figures, tables, equations, and sections
- LaTeX equations — Full LaTeX math rendering in output
- PDF generation — Professional typography via LaTeX
- EPUB generation — Publish ebooks from markdown
- Beamer presentations — Academic slides from markdown
Craft Markdown doesn't handle citations, equations, cross-references, or publishing workflows. If you're writing academic papers or producing professional publications, Pandoc is the right tool.
Privacy Comparison
Both tools process files locally — a genuine tie:
Craft Markdown: Files processed in-browser via JavaScript. Nothing touches a server. This is architecturally guaranteed — there's no server-side processing code. Even if the server were compromised, it couldn't access your files because the conversion never involves the server.
Pandoc: Files processed locally on your machine via a locally installed application. Nothing leaves your computer. As an installed application, it never contacts any server during conversion.
Verdict: Tie. Both tools offer real privacy through local processing. The difference is convenience — Craft Markdown requires no installation to get that privacy. If you're on a computer where you can't install software (corporate lockdown, shared machine, borrowed laptop), Craft Markdown gives you local-processing privacy from any browser.
Conversion Quality Comparison
Both tools produce high-quality markdown output, but with different strengths:
PDF to Markdown
- Craft Markdown: Good handling of text-based PDFs. Tables, headings, and lists are generally well-preserved. Browser-based PDF parsing handles most common document layouts.
- Pandoc: Requires additional tools (
pdftotextfrom Poppler) for PDF processing. When properly configured, Pandoc produces clean output — but the configuration step is non-trivial.
DOCX to Markdown
- Craft Markdown: Good conversion of standard Word documents. Headings, bold, italic, lists, tables, and links convert cleanly.
- Pandoc: Excellent DOCX conversion — this is one of Pandoc's strongest capabilities. Handles tracked changes, comments, footnotes, and complex formatting features that other tools miss.
HTML to Markdown
- Craft Markdown: Good for article content and web pages. Strips CSS, JavaScript, and navigation effectively.
- Pandoc: Excellent HTML parsing with configurable stripping options. Better at handling edge cases and malformed HTML.
Overall: For standard documents (well-formatted PDFs, clean Word docs, article HTML), both produce excellent output. Pandoc has an edge on complex edge cases, deeply nested structures, and documents with academic formatting. Craft Markdown has an edge on data formats (CSV, JSON, Excel) that Pandoc doesn't support.
Side-by-Side Feature Matrix
| Capability | Craft Markdown | Pandoc |
|---|---|---|
| PDF → Markdown | Yes | Yes (requires pdftotext/poppler) |
| DOCX → Markdown | Yes | Yes (excellent) |
| HTML → Markdown | Yes | Yes |
| CSV → Markdown | Yes | No |
| JSON → Markdown | Yes | No |
| Excel → Markdown | Yes | No (limited XLSX support) |
| XML → Markdown | Yes | Yes (via DocBook/JATS) |
| TXT → Markdown | Yes | Yes |
| RTF → Markdown | Yes | Yes |
| Markdown → PDF | No | Yes |
| Markdown → DOCX | No | Yes |
| Markdown → HTML | No | Yes |
| Markdown → EPUB | No | Yes |
| Markdown → LaTeX | No | Yes |
| Markdown → Slides | No | Yes (Beamer, reveal.js) |
| Batch conversion | Multi-file drop | Full scripting |
| Custom templates | No | Yes (extensive) |
| Lua filters | No | Yes |
| Citations (BibTeX) | No | Yes (Citeproc) |
| Cross-references | No | Yes |
| Math/LaTeX | No | Yes |
| Visual interface | Yes | No (third-party GUIs available) |
| Preview | Yes | No |
| Installation | None | Required |
Who Should Use Which Tool?
Choose Craft Markdown If:
- You want to convert a file right now without installing anything
- You're not comfortable with command-line tools or don't want to use one
- You're converting files to markdown (not to PDF, Word, EPUB, or other formats)
- You're preparing documents for AI, ChatGPT, Claude, or RAG systems
- You want visual preview before downloading
- You need to convert CSV, JSON, or Excel files to markdown tables
- You're recommending a tool to non-technical colleagues, clients, or team members
- You need occasional conversions, not automated pipelines
Choose Pandoc If:
- You're a developer comfortable with the terminal
- You need to convert between non-markdown formats (DOCX → PDF, Markdown → EPUB)
- You need batch processing for hundreds or thousands of files
- You need custom templates, Lua filters, or output transformation
- You're building automated documentation pipelines or CI/CD workflows
- You need academic features — citations, cross-references, LaTeX math
- You want maximum control over every aspect of conversion
Use Both If:
- You use Pandoc for batch automation and CI/CD, but want a quick browser tool for one-off conversions
- Your team includes developers (Pandoc) and non-developers (Craft Markdown)
- You use Pandoc for non-markdown output but prefer Craft Markdown's AI-optimized output for converting to markdown
- You need data format conversion (CSV, JSON, Excel → Markdown) alongside document conversion
Verdict
Pandoc is the more powerful tool. It supports more formats, offers deeper customization, and can be automated at scale. If you're a developer building conversion pipelines, an academic producing publications, or a documentation team with CI/CD integration, Pandoc is exceptional and irreplaceable.
Craft Markdown is the more accessible tool. It requires zero setup, has a visual interface, produces AI-optimized output, handles data formats Pandoc doesn't, and anyone can use it. For the vast majority of people who need to convert a document to markdown, Craft Markdown is the better experience.
The honest answer: Most users don't need Pandoc's power. They need to convert a PDF, Word doc, or spreadsheet to markdown, and they need it done in 10 seconds without installing anything, reading documentation, or opening a terminal. That's Craft Markdown.
If you're one of those users:
If you need Pandoc's full power, install it from pandoc.org — it's free and excellent. We recommend it without reservation for the use cases where it shines.
Frequently Asked Questions
Is Craft Markdown built on Pandoc?
No. They're completely separate tools with different architectures. Craft Markdown uses browser-based JavaScript libraries (Turndown, pdf.js, Mammoth, and others) for conversion. Pandoc is a Haskell application that runs locally. They share no code.
Can Pandoc do everything Craft Markdown does?
For document formats (PDF, DOCX, HTML), mostly yes — Pandoc can convert these to markdown. However, Pandoc doesn't natively handle CSV, JSON, or Excel files as input formats. Craft Markdown also produces AI-optimized output by default, which requires manual Pandoc configuration (specific flags and potentially custom filters) to achieve.
Is Craft Markdown as accurate as Pandoc?
For standard documents — well-formatted PDFs, Word docs, clean HTML — both produce excellent output. Pandoc has an edge on complex documents with nested structures, tracked changes, footnotes, and academic formatting. Craft Markdown has an edge on data formats (CSV, JSON, Excel) and produces AI-optimized output by default.
Can I use both tools together?
Absolutely, and many users do. A common setup: Craft Markdown for quick, one-off conversions when you need markdown from a document in 10 seconds. Pandoc for batch processing, automated pipelines, and any conversion that needs non-markdown output (PDF, DOCX, EPUB). They complement each other well.
Does Pandoc have a GUI?
Not officially, but several options exist. Pandoc.org now offers a browser-based interface at pandoc.org/app for simple conversions. Third-party GUIs like PanWriter (markdown editor with Pandoc export) also exist. None are as polished or purpose-built as Craft Markdown's interface for the specific task of converting files to markdown.
Which is better for converting PDFs to markdown?
Both handle text-based PDFs well. Pandoc requires additional tools (pdftotext from the Poppler library) for PDF processing. Craft Markdown handles PDFs natively in the browser. For quick conversions, Craft Markdown is faster to start. For batch PDF processing, Pandoc with pdftotext is more efficient.
Which handles Word documents better?
Pandoc has stronger DOCX support — it handles tracked changes, footnotes, comments, and complex formatting features. For standard Word documents (headings, lists, tables, bold/italic, links), both produce clean output. Choose Pandoc if your Word documents use advanced features; choose Craft Markdown if you want the fastest path from DOCX to markdown.