How do I convert a Word document to Markdown?

Upload the .docx to POST /v1/convert exactly as you would a PDF — the endpoint takes the file type from the upload, so no format parameter is needed.

Are headings, lists and tables preserved from Word?

Yes. DOCX carries explicit structure, so heading levels, lists and tables map cleanly onto Markdown — Word is one of the most faithful conversions mdkit does.

What happens to images embedded in a Word file?

The Markdown output is text. If you need the document's full structural representation, submit it through the async lane and fetch the result with format=json.

Convert Word (DOCX) to Markdown

Convert a Word document to Markdown via the mdkit REST API — headings, lists and tables come out as clean Markdown structure.

Last updated 2026-07-26

Word documents (.docx) convert synchronously on POST /v1/convert. Headings, lists and tables in the document come out as Markdown structure, which is exactly what an LLM or a RAG chunker wants.

curl

The DOCX MIME type is long — set it explicitly so the upload passes the content-type check:

curl -F "file=@spec.docx;type=application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
  https://api.mdkit.online/v1/convert

Notes

Sync uploads are capped at 8 MB; bigger files go through async jobs (up to 50 MB).
Unsupported types are rejected with 415 — accepted types are PDF, DOCX, PPTX, XLSX, HTML and plain text.
Anonymous calls are rate-limited per IP; send an X-API-Key header to lift the limit.

Try it

Try it free — or test the pipeline with the free HTML→Markdown tool.

FAQ

How do I convert a Word document to Markdown?: Upload the .docx to POST /v1/convert exactly as you would a PDF — the endpoint takes the file type from the upload, so no format parameter is needed.
Are headings, lists and tables preserved from Word?: Yes. DOCX carries explicit structure, so heading levels, lists and tables map cleanly onto Markdown — Word is one of the most faithful conversions mdkit does.
What happens to images embedded in a Word file?: The Markdown output is text. If you need the document's full structural representation, submit it through the async lane and fetch the result with format=json.