MakeItMarkdown vs pandoc

MakeItMarkdown · July 2026 · 5 min read

Let's start with respect: pandoc is one of the great pieces of open-source software — a universal document converter that reads and writes dozens of formats and has anchored publishing pipelines for nearly two decades. If your task is "convert anything to anything, scriptably", pandoc is the answer and this page won't pretend otherwise.

The comparison exists because "get this file into an LLM" is a different task than "convert this file" — and the differences are exactly where the two tools diverge.

1 · Where pandoc is simply better

• Format breadth — LaTeX, EPUB, DocBook, org, reStructuredText, and everything between, in and out.
• Scriptability — a CLI in a Makefile beats a browser tab for converting 400 files on a schedule.
• Publishing features — citations, filters, templates; it's a typesetting ecosystem, not just a converter.

2 · Where the LLM task diverges

• The fidelity report. pandoc's contract is "convert what's convertible"; loss is silent by design. Our contract is "tell you what was detected and what's shaky" — counts, warnings, and a structural QC score per file. When the output feeds a model that can't complain about missing tables, the report is the product.
• Notebook semantics. pandoc converts .ipynb structurally; it doesn't give cells stable addresses, flag out-of-order execution, or annotate cell dependencies — the things that make a notebook askable-about.
• LLM-specific output discipline. Typed table headers, explicit truncation sentences, token estimates and an exact o200k count, chunk anchors for RAG — none of these are conversion in pandoc's sense; all of them change model behavior.
• Zero install, zero shell. The person with a failing PDF in a chat window is usually not the person with a package manager open. A browser tab that works offline is the right shape for that moment.

3 · Privacy is a tie

Both run entirely on your machine — pandoc as a local binary, MakeItMarkdown as local JavaScript (verify it: load once, go offline, convert). Both beat any upload-based service for confidential files.

4 · The honest recommendation