Pandoc
A command-line document converter that uses a common abstract syntax tree to transform Markdown, DOCX, HTML, EPUB, LaTeX, PPTX and other markup and document formats.
What Pandoc does
Pandoc reads a document into an abstract syntax tree and writes it into another supported format. It is useful for Markdown, DOCX, HTML, EPUB, LaTeX, PPTX and notebook workflows, with templates and filters for controlled customization. It prioritizes structure rather than promising pixel-perfect round trips.
Conversion and PDF boundaries
Formats have different layout models. Complex tables, text boxes, margins, comments, macros and proprietary styles may change during conversion, so keep one authoritative source and inspect the generated file. PDF output usually depends on a separate LaTeX, HTML, Groff or other engine, while Lua and external filters are executable code that require source and version review.
Maintenance note
This page reviews Pandoc 3.10.1 for Windows, readers and writers, conversion differences, PDF engines, templates, filters and GPL-2.0-or-later boundaries. Content review date: 2026-08-23.
Save to your cloud drive
Open the cloud drive to get the file directly, or save it for convenient access on another device.
Quark Cloud Drive
RecommendedSave Pandoc to this cloud drive
Baidu Netdisk
Save Pandoc to this cloud drive
Pandoc Windows document conversion guide
Convert a simple Markdown sample first, then add images, tables, citations and templates one at a time. Keep the source and write each result into a new directory.
Before you start
- Prepare a test document with headings, lists, links, images and a simple table, keeping the original copy.
- Define input and output formats and note Markdown dialect or template requirements.
- For PDF, choose a supported engine separately and verify fonts, language support and Chinese typesetting.
Installation steps
- 01
Install the Windows MSI
Verify version and x64 architecture, run the MSI and open a new terminal to confirm that pandoc is available on PATH.
- 02
Create an isolated test directory
Copy only sample documents and resources into the directory so conversion commands do not read or overwrite real work files.
- 03
Confirm the toolchain
Test DOCX, EPUB and HTML directly; for PDF, verify the selected engine, fonts and environment variables before adding complex content.
Quick start
- 01
Convert simple Markdown
Specify a Markdown input and a new HTML or DOCX output, then inspect headings, lists, links, code blocks and Chinese characters.
- 02
Add complex elements gradually
Add images, tables, footnotes and citations one at a time, comparing each result to identify features that degrade in the target format.
- 03
Fix a repeatable command
Record input format, output format, resource paths and template version, and make automation write to a new output directory every time.
Usage tips
- Repeated round trips accumulate layout loss; choose an authoritative source format rather than alternating between DOCX and Markdown.
- Lua and external filters can transform the syntax tree and execute code, so pin their source and version and run them in a restricted test directory.
- For sensitive documents, inspect temporary files, extracted images, command history and generated artifacts, and keep content away from unknown online services.
Troubleshooting and uninstall
Why does PDF generation report a missing engine?
Install and configure a supported PDF engine, verify its command is on PATH in a new terminal, and check fonts and language packages.
Why did layout change from DOCX to Markdown?
This is a normal difference between format models. Identify complex tables, text boxes and styles, then adjust the conversion strategy or retain the original format.
- Remove Pandoc and optional enginesUninstall Pandoc through the system application manager; LaTeX and other PDF engines are separate software and should be handled individually.
Frequently asked questions
Can Pandoc convert every document without loss?
No. It preserves document structure where possible, while page margins, complex tables, text boxes, comments, macros and fine typography may change. Review every important output.
Does the Pandoc MSI include everything needed for PDF?
Pandoc can invoke PDF output, but a separate LaTeX, HTML, Groff or other supported engine and its fonts may be required.
Are Pandoc filters and templates safe by default?
Filters are executable code and templates or resources affect output. Inspect their source and run unknown components in a low-privilege isolated directory first.