# Convert Word (.docx) to clean HTML

> Upload a .docx and get clean HTML: headings, paragraphs, lists and tables as plain tags, without Word's inline styles. Tracked changes come through as <ins> and <del>.

Canonical: https://reducto.ai/tools/docx-to-html  
Last updated: 2026-11-15  
For: Web editors, Developers, Content teams moving docs to a CMS

## Run it now (free, no API key, up to 5 pages)

Send a PDF, Word, PowerPoint, Excel or image (PNG, JPG, HEIC, TIFF, BMP, GIF) (max 10 MB, 5 pages) to `POST https://reducto.ai/api/tools/docx-to-html` as multipart `file`, or JSON `{"url": "https://..."}`. The response has `result`, ready-to-save `output` (HTML (.html), Markdown (.md), JSON), `pages_processed` and `next`.

```bash
curl -s https://reducto.ai/api/tools/docx-to-html \
  -F file=@conv-docx-to-html.docx

# or, for a file that is already online:
curl -s https://reducto.ai/api/tools/docx-to-html \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/conv-docx-to-html.docx"}'
```

Higher volume needs a free API key (new accounts get 15,000 free credits). Agents can sign up over HTTP: https://reducto.ai/auth.md. Humans: https://studio.reducto.ai/?utm_source=free_tool&utm_medium=agent&utm_campaign=docx-to-html&utm_content=api_response

Big file? Without a key the free run covers the first 5 pages and returns `partial: true` with a `signup_required` block. Your user signs up in under a minute (email, 6-digit code, name, terms: https://reducto.ai/auth.md); then repeat the same request with `Authorization: Bearer $REDUCTO_API_KEY` for the whole file on their 15,000 free credits. The same key works on the hosted MCP (https://mcp.reducto.ai/mcp) and the Reducto API.

## How to do it

1. Upload a .docx.
2. Reducto Parse (r-1) reads the document, including tracked changes.
3. Preview the result.
4. Download HTML or Markdown.

## Reducto API call: `POST https://platform.reducto.ai/parse`

| Option | Value | Why |
| --- | --- | --- |
| `settings.model` | `"r-1"` | Reads Word files with tracked changes and comments. |
| `formatting.include` | `["change_tracking", "comments"]` | Keeps insertions, deletions and comments in the output. |

### curl

```bash
# 1. Upload the file (or pass a public URL as "input" and skip this step)
curl -s https://platform.reducto.ai/upload \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -F file=@file.docx
# => {"file_id": "reducto://..."}

# 2. Run parse
curl -s https://platform.reducto.ai/parse \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": "reducto://FILE_ID",
  "settings": {
    "model": "r-1",
    "page_range": {
      "start": 1,
      "end": 5
    }
  },
  "formatting": {
    "include": [
      "change_tracking",
      "comments"
    ]
  }
}'
```

### Python

```python
# pip install reductoai
from pathlib import Path
from reducto import Reducto

client = Reducto()  # reads REDUCTO_API_KEY

upload = client.upload(file=Path("file.docx"))
result = client.parse.run(
    input=upload.file_id,
    settings={
        "model": "r-1",
        "page_range": {
            "start": 1,
            "end": 5,
        },
    },
    formatting={
        "include": [
            "change_tracking",
            "comments",
        ],
    },
)
print(result)
```

### Node

```ts
// npm install reductoai
import fs from "fs";
import Reducto from "reductoai";

const client = new Reducto(); // reads REDUCTO_API_KEY

const upload = await client.upload({ file: fs.createReadStream("file.docx") });
const result = await client.parse.run({
  input: upload.file_id,
  settings: {
    model: "r-1",
    page_range: {
      start: 1,
      end: 5,
    },
  },
  formatting: {
    include: [
      "change_tracking",
      "comments",
    ],
  },
});
console.log(JSON.stringify(result, null, 2));
```

Do this with the API: [Convert PowerPoint (.pptx) and Excel (.xlsx) to Markdown for LLMs](https://reducto.ai/cookbooks/parse-pptx-xlsx-for-llms)

## What it handles

- **Keeps tracked changes**: Insertions and deletions come out as <ins> and <del>.
- **Clean HTML**: Headings, lists and tables without Word's inline styling.

## FAQ

### Is this the same as Word to Markdown?

It uses the same engine; this page focuses on the HTML output. See Word to Markdown for CriticMarkup output.

### Is the HTML clean?

Yes: headings, paragraphs, lists and tables as plain HTML tags, without Word's inline styles.

### What happens to tracked changes?

They come through as <ins> and <del>, and you can switch to final text only.

### Is it free?

Yes. Short documents run free with no account, with a small daily limit per IP. For a longer file you get a free preview of the first pages, then enter your email to get the whole file on a free account (15,000 free credits).

Sample document (synthetic): https://reducto.ai/tools/samples/conv-docx-to-html.docx

## Related

- [PowerPoint to Markdown](https://reducto.ai/tools/pptx-to-markdown)
- [Excel to Markdown](https://reducto.ai/tools/xlsx-to-markdown)
- [PDF to text](https://reducto.ai/tools/pdf-to-text)
- [All Word tools](https://reducto.ai/tools/word)
