Docs · Conversion
Word DOCX to Markdown
Convert modern Word documents into Markdown — headings, paragraphs, lists, and tables.
POST
/v1/convert/docx-to-markdown Customer supplies the .docx file as base64. Preserves Word heading styles as Markdown headings (Heading 1 → #, Heading 2 → ##, …), list-bullet/list-number styles, and tables (rendered as Markdown tables with header row). Images and comments are dropped. Does NOT support legacy .doc (binary Word format) — convert to .docx first.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| docx_base64 | string | yes | — | Base64-encoded .docx bytes. |
Request
curl -X POST https://api.qcrawl.com/v1/convert/docx-to-markdown \
-H "Authorization: Bearer osk_..." \
-d '{"docx_base64": "UEsDBBQABgAIA..."}'Response
{
"status": "success",
"markdown": "# Test Document\n\nThis is a paragraph...\n\n## Section Two\n\n| Header A | Header B |\n|---|---|\n| Cell 1A | Cell 1B |",
"byte_count": 412,
"word_count": 53,
"paragraph_count": 4,
"table_count": 1
}Errors
| Code | Meaning |
|---|---|
| 400 | invalid base64, empty body, not a valid .docx, or legacy .doc binary. |