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.
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://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-Keyheader to lift the limit.
Try it
Try it free — or test the pipeline with the free HTML→Markdown tool.