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

Word to Markdown · HTML DOCX to HTML: clean HTML from a Word document

Word’s own “Save as web page” produces kilobytes of styles and Office markup. This converter writes plain h1–h6, p, ul, ol, table, a and img tags that you can paste into a CMS or an email builder, with the file never leaving your device.

  • Files stay on your device
  • No inline styles
  • Images in a ZIP or embedded

Convert DOCX to HTML

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 WordHTML
    Heading 1 style
    <h1>Annual report</h1>
    Heading 2 style
    <h2>Key results</h2>
    Bold and italic
    <p>Plain, <strong>bold</strong><em> and italic</em></p>
    Hyperlink
    <p><a href="https://tapcub.com/">TapCub</a></p>
    Bullet with a numbered sub-item
    <ul>
      <li>Check headings
        <ol>
          <li>One H1 per page</li>
        </ol>
      </li>
    </ul>
    Table
    <table>
      <thead>
        <tr><th>Month</th><th>Visits</th></tr>
      </thead>
      <tbody>
        <tr><td>May</td><td>12,400</td></tr>
      </tbody>
    </table>
    Picture with alt text
    <p><img src="images/image1.png" alt="Sales chart"></p>
    Footnote
    <p>Survey result<sup id="fnref-1"><a href="#fn-1">1</a></sup></p>
    <section class="footnotes">
    <ol>
      <li id="fn-1">Sample of 1,200 users, 2026. <a href="#fnref-1">↩</a></li>
    </ol>
    </section>

    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 is this different from Word’s “Save as Web Page”?

    Word keeps its formatting with mso- styles, conditional comments and extra spans. This tool keeps only the structure, so the HTML takes your site’s own styles.

    Can I get a complete HTML page?

    Yes. Set HTML to “Full page” to add the doctype, head, title and body around the content.

    How do I keep images in a single HTML file?

    Choose “Embed in the file”. Images are written as base64 data addresses, which makes the file larger but self-contained.

    Are styles like colours and fonts kept?

    No, on purpose. Colours, fonts and sizes are left to your stylesheet. Bold, italic, strikethrough and links are kept as tags.

    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