TapCub is live — analytics, insights and live chat, free on one platform

Free tool · Files Word to Markdown: convert DOCX to clean Markdown

Drop a Word document and get Markdown you can paste into a CMS, a docs site, a GitHub README or an AI chat. Headings, bold and italic, links, nested lists, tables, footnotes and images come across; fonts and colours are left behind. The file is read by your browser and never uploaded.

  • Files stay on your device
  • Headings, lists and tables kept
  • Images in a ZIP

Convert Word to Markdown

Choose a .docx file. The result appears below; change the output or image settings at any time.

Convert

No file yet. Choose or drop a .docx file, or try the sample document.

    ZIP: the Markdown links to images/ and both download together.

    A full page adds <html>, <head> and <body>.

    How Word elements are written

    Each row was converted with the same code the tool runs. Word styles decide the structure: a paragraph in the Heading 1 style becomes #, whatever its font size.

    How Word elements are written
    In WordMarkdown
    Heading 1 style
    # Annual report
    Heading 2 style
    ## Key results
    Bold and italic
    Plain, **bold** *and italic*
    Hyperlink
    [TapCub](https://tapcub.com/)
    Bullet with a numbered sub-item
    - Check headings
      1. One H1 per page
    Table
    | Month | Visits |
    | --- | --- |
    | May | 12,400 |
    Picture with alt text
    ![Sales chart](images/image1.png)
    Footnote
    Survey result[^1]
    
    [^1]: Sample of 1,200 users, 2026.

    Text that only looks like a heading (big and bold, Normal style) stays a paragraph. Apply real heading styles in Word for a clean outline.

    Your files never leave this device: they are read and converted by your browser, and nothing is uploaded to TapCub or anyone else. To check, open your browser’s developer tools, go to the Network tab and run the tool: no file is sent.

    Version v1.0Updated Update history

    Read the result

    What survives the conversion

    Markdown describes structure, not appearance. Here is what comes across and what is dropped on purpose.

    Structure

    Headings come from Word’s heading styles (or outline levels), lists from Word’s bullets and numbering, including nesting. Tables become GitHub-style pipe tables; merged cells are split into empty cells, because Markdown tables cannot merge.

    Inline formatting

    Bold, italic, strikethrough, monospace text (as inline code) and external links are kept. Underline, colours, highlight and fonts have no Markdown equivalent and are dropped.

    Images

    Pictures are written as ![alt](images/image1.png) and the files are packed into a ZIP with the Markdown. The alt text is taken from the picture’s description in Word, so fill that in.

    Left out

    Headers, footers, comments, page breaks and the table of contents. Text boxes are kept as normal paragraphs after the paragraph that holds them.

    For a quick check of the Markdown, open the preview below the result, or paste it into the Markdown converter.

    How to use it

    Convert a Word document in four steps

    The defaults suit a blog post or a docs page.

    1. 1

      Choose the .docx

      Drop it on the box or click to pick it. Old .doc files need to be saved as .docx first.

    2. 2

      Pick the output

      Markdown for a CMS, static site generator, README or an AI tool; HTML for an editor that takes HTML.

    3. 3

      Decide on images

      ZIP gives you the Markdown plus an images folder; embed puts everything in one file; or leave images out.

    4. 4

      Copy or download

      Copy the text into your editor, or download the .md / .html (or the ZIP with images).

    How it works

    How the converter reads a .docx

    A .docx file is a ZIP archive of XML files (the Office Open XML format, ECMA-376). The tool unpacks it with the browser’s built-in decompression and reads the parts it needs.

    • word/document.xml holds the paragraphs, runs of text and tables, in reading order
    • word/styles.xml says which paragraph styles are headings; word/numbering.xml says whether a list is bulleted or numbered and where it starts
    • word/_rels/document.xml.rels maps link and picture IDs to web addresses and to files in word/media/
    • Footnotes and endnotes come from footnotes.xml and endnotes.xml and are written as [^1] references
    • Markdown output follows GitHub Flavored Markdown; characters that would accidentally format text (such as * or _) are escaped
    Parts of a .docx file the tool reads
    PartWhat it holdsUsed for
    word/document.xmlBody text and tablesEverything you see
    word/styles.xmlStyle names and outline levelsHeadings, quotes, code
    word/numbering.xmlList formats and start valuesBullets and numbers
    word/media/*Picturesimages/ folder in the ZIP
    word/footnotes.xmlFootnote text[^1] notes at the end
    Worked example

    A Word section becomes Markdown

    A short section with a Heading 2, a sentence with bold and a link, and a two-level list.

    From Word to Markdown, line by line
    In WordMarkdown
    “Key results” in the Heading 2 style## Key results
    “Visits rose 18%” with 18% in boldVisits rose **18%**
    “See the report” linked to a web page[See the report](https://…)
    Bullet “Channels”, numbered sub-item “Search”- Channels / 1. Search (indented two spaces)
    A 2 × 3 tableA header row, a --- row and one row per table row

    The numbered sub-item is indented under the bullet by the width of “- ”, which is what Markdown needs to nest it.

    Common mistakes

    Where Word to Markdown goes wrong

    Most problems start in the Word file, not in the conversion.

    Fake headings

    Big bold text in the Normal style is just a paragraph. Use Heading 1, 2 and 3 in Word and the outline comes out right.

    Typed numbers

    Lines that start with a typed “1.” are not a Word list. Use the numbering button so the converter can see the list and its levels.

    Images without alt text

    The alt text in Markdown comes from the picture’s description in Word. Fill it in (right-click › Edit Alt Text) for accessibility and SEO.

    Layout tables

    Tables used to position things on the page become real tables in Markdown. Replace them with plain paragraphs before converting.

    FAQ

    Word to Markdown questions

    Still have a question?

    Chat with the team behind TapCub — we usually reply within a few hours on business days.

    How do I convert a Word document to Markdown?

    Drop the .docx file on the converter. The Markdown appears at once; copy it or download it as a .md file, or as a ZIP if the document has pictures.

    Can I convert an old .doc file?

    Not directly. .doc is a different, binary format. Open it in Word, WPS or LibreOffice, save it as .docx and convert that.

    Are my documents uploaded?

    No. The .docx is unpacked and converted by your browser. You can check in the developer tools’ Network tab, or switch off the internet after the page has loaded.

    What happens to images?

    By default they are saved in an images folder inside a ZIP and the Markdown links to them. You can also embed them in the file as base64 or leave them out.

    Why did my heading become a normal paragraph?

    Because it is formatted to look like a heading but uses the Normal style. Apply Heading 1–6 in Word, or set an outline level, and convert again.

    Does it work with Google Docs?

    Yes. In Google Docs use File › Download › Microsoft Word (.docx), then drop that file here.

    Is the Markdown good for ChatGPT or other AI tools?

    Yes. Markdown keeps headings, lists and tables as plain text, which AI tools read more reliably than pasted Word text. Leave images out for that use.

    Changelog

    Update history

    New features, fixes and data refreshes for this tool, newest first.

    1. · v1.0

      LaunchedFirst release.

    Missing something or found an error? Tell us — requests that come up often go into the next update. All tool updates

    See your data clearly. Find your growth.

    Every click, backed by data. Install one line of code and see your first numbers in a minute.

    No credit card · Free plans for analytics and chat · Cookieless analytics