# DOCX to markdown

- Human page: https://happytails.ai/en/document-tools/docx-to-markdown/
- Markdown: https://happytails.ai/en/document-tools/docx-to-markdown.md
- Structured JSON: https://happytails.ai/agents/en/document-tools/docx-to-markdown/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `docx-to-markdown` |
| Category | document-tools |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Use the visible action or interactive controls. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Converts semantic document content. Complex layout, floating images, fields and tracked changes require review.

### Inputs and settings

No free-text input is required. Use the file inputs and/or settings below.

Accepted browser files: `.docx`. Choose one file.

No additional settings are declared for this tool.

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Extract semantics, links, lists and images; document unsupported layout and styles.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "docx-to-markdown",
  "category": "document-tools",
  "built": true,
  "requirements": "Extract semantics, links, lists and images; document unsupported layout and styles.",
  "implementation": {
    "fields": [],
    "files": true,
    "input": false,
    "accept": ".docx",
    "note": "Converts semantic document content. Complex layout, floating images, fields and tracked changes require review.",
    "experience": {
      "automatic": false,
      "single": false,
      "label": "Your text",
      "placeholder": "Type or paste your input…",
      "help": "Up to 1,000,000 characters. Review the settings before running.",
      "action": "Convert file"
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Extract semantics, links, lists and images.

## Useful next steps

- [Markdown to HTML](https://happytails.ai/en/text-tools/markdown-to-html/): Convert Markdown into HTML source. ([Markdown](https://happytails.ai/en/text-tools/markdown-to-html.md))

- [Markdown to PDF](https://happytails.ai/en/document-tools/markdown-to-pdf/): Render defined Markdown dialect with print CSS, fonts and page breaks. ([Markdown](https://happytails.ai/en/document-tools/markdown-to-pdf.md))

- [PDF to markdown](https://happytails.ai/en/pdf-tools/pdf-to-markdown/): Save extracted PDF text as a Markdown file. ([Markdown](https://happytails.ai/en/pdf-tools/pdf-to-markdown.md))

## How to use DOCX to markdown

1. Choose a file in DOCX.
2. Review the settings, then choose Convert file.
3. Review the result, then use Copy result or a download link when available.

## Working with docx to markdown

Documents contain more than visible words: headings, tables, page order and embedded images affect how people read them. A conversion into plain text or Markdown can simplify reuse while losing some of the original layout.

## Common questions

### Can a document summary replace the original?

A summary omits information by design. Use source references to verify important statements and return to the full document for qualifications, definitions or exceptions.

### Why should extracted tables be checked?

Merged cells, decimal separators, missing headers and reading-order errors can put correct-looking values in the wrong column. Keep a preview linked to the original so those errors are easy to correct.

Continue your workflow: [Markdown to HTML](https://happytails.ai/en/text-tools/markdown-to-html/), [Markdown to PDF](https://happytails.ai/en/document-tools/markdown-to-pdf/), [PDF to markdown](https://happytails.ai/en/pdf-tools/pdf-to-markdown/).