Docuboxer
By ··6 min read

Convert Word to Markdown without losing tables

Convert a Word file to Markdown and keep the tables, headings and lists. What gets left out (equations, comments), the image options and the Pandoc route.

To convert Word to Markdown and keep the tables, open Word to Markdown, drop in the .docx file, and download the .md. The conversion runs in your browser. Headings, lists, tables, links, bold and italic come across; equations, comments and tracked changes do not.

What survives the conversion?

Headings become # headings by level, lists become dashed or numbered lists, and tables become pipe tables. Markdown has only one table form: a header row and then the data rows. So the tool promotes the first row of each table to a header, even if the Word table had none, and turns paragraphs inside a cell into line breaks.

Merged cells have no equivalent in that syntax. If your table has joined cells, check the output and fill in the ones that split. To fix a table by hand, the Markdown cheat sheet covers the syntax for tables, lists and headings.

What happens to the images?

By default the images are omitted, so the Markdown is text only, which is the cheapest option in tokens. You can embed them in the Markdown as base64, with a cap of 20 MB of base64 in total, or download a ZIP with the .md file (named after your Word file) and an images/ folder. In that case the image paths in the Markdown already point to that folder.

When to use Pandoc instead

If you convert documents every day, or they are very large, Pandoc reads .docx and writes GitHub Markdown from the terminal: pandoc document.docx -t gfm -o document.md. You have to install it; Docuboxer's tool needs nothing. For a single file, converting in the browser avoids an install.

If the Markdown is going to an AI model, read how many tokens your document is first: the token count matters as much as the format.

Frequently asked questions

Does converting Word to Markdown lose the formatting?

Partly. Markdown has no fonts, colors or page breaks. Headings, lists, tables, links, bold and italic come across. If the visual layout matters, keep the original Word file too.

Do the tables come out right?

Simple tables do. The first row of each table becomes the header, because Markdown requires one. Merged cells have no equivalent in that syntax, so check them after converting.

Is the document uploaded to a server?

No. The conversion runs in your browser, and the file is never sent to a server.

How big a file can it handle?

Up to 50 MB per .docx file. An old binary .doc is not supported: open it in Word and save it as .docx before converting.

What about equations and comments?

The tool warns that it does not include equations, comments, tracked changes, SmartArt or text boxes. If your document depends on any of them, review the output before you use it.

How many tokens is the Markdown?

The tool shows the exact GPT count, using the o200k_base tokenizer, and an approximate estimate for Claude. It tells you how much room the text will take before you paste it into a chat.

Convert your Word file now

No upload. Free, and it runs in your browser.

Word to Markdown →

Related tools

Sources