# Word to Markdown

Turn a Word document (.docx) into Markdown with its headings, lists, tables, links, bold and footnotes.

Reads the text of a Word document straight from the file and writes it as Markdown. Made for giving a document to a language model: structure is kept, layout is not.

- Endpoint: `POST https://setget.net/v1/tools/docx-to-markdown` with JSON `{"input": {...}}` (add `"wait": 30` to hold the reply until the job finishes)
- MCP: `run_tool` with `slug` = `docx-to-markdown`
- Page: https://setget.net/tools/docx-to-markdown

## Files in, files out

This is a file tool. Its file inputs take file references, not file contents and not web addresses.

- Get a reference by uploading: `curl -T FILE https://setget.net/drop/` prints a line `ref  <id>/f1`. Or `POST https://setget.net/v1/drops` with `{"files":[{"name","size"}]}`, PUT the bytes to the returned `upload.url` with the listed headers, and use the file's `ref`. Over MCP use the `drop` tool. A file under about 700 KB can also be sent in place as a `data:<type>;base64,<content>` URI.
- Uploads are at most 100 MB per file, are readable by anyone with the link, and expire (one hour by default). Programs are refused.
- The tool runs as a job. The reply is `{"tool", "ms", "result", "files", "job"}`: `result` is JSON, and every result file comes back in `files` as `{"name", "size", "content_type", "kind", "url", "ref"}`. Download it from `url`, or pass `ref` as the input of another file tool.
- A job still running when the wait ends answers 202 with `job`. Follow it with `GET https://setget.net/v1/jobs/<id>?wait=30`, or stream progress from `GET https://setget.net/v1/jobs/<id>/events` (over MCP: the `job` tool). A person can watch it at `job.url`.

## Inputs

- `file` (required, file, a file reference such as `DROP_ID/f1`, accepts zip, binary): The Word document (.docx) to convert.

## Example: A Word document as Markdown

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.docx](https://setget.net/static/samples/sample.docx).

```json
{"input":{"file":"DROP_ID/f1"},"wait":30}
```

**What is kept?** Headings (from the Heading styles and the Title style), paragraphs, bold, italic and strikethrough, bulleted and numbered lists with their levels, tables, links, footnotes and endnotes, and the text of text boxes.

**What is left out?** Pictures and charts (the result says how many), headers and footers, comments, and text that was deleted with change tracking on.

**My headings came out as plain or bold text. Why?** They were made by hand with a large or bold font rather than with a Heading style. Only styles say what a heading is.

**Can it read .doc files?** No, only .docx. Open the .doc in your office program and save it as .docx first.

**Where is the Markdown?** In a file named after your upload, ending in .md. The result also holds the Markdown itself in "markdown" when it is up to 200,000 characters; "truncated" is true when only the start fits there.

**Does it fetch anything from the internet?** No. Links and picture addresses found in the file are copied as text. Nothing they point to is opened or downloaded.
