Convert a Word .docx file to clean Markdown or a README.md: headings, bold and italic, links, lists and tables are kept. The file is converted in your browser and never uploaded.
Works in your browser. What you paste or upload is processed on your device.
Drag a .docx file onto the drop zone, or click it and pick the file.
Keep placeholder links, embed images as Base64, or remove them.
Switch between the Markdown and Preview tabs to check headings, lists and tables.
Download the .md file (tick Save as README.md for a repo README) or copy the Markdown.
A Word to Markdown converter turns a Microsoft Word document (.docx) into Markdown, so you can publish it in a README, a docs site, a static site generator or any CMS that accepts Markdown. Drop a .docx file here and the Markdown appears with a preview, ready to copy or download as a .md file or as README.md.
Headings that use Word's Heading styles (and the Title and Subtitle styles) become # headings. Bold, italic, strikethrough, links, bulleted and numbered lists (including nested ones) and tables are kept, and tables come out as GitHub Flavored Markdown pipe tables. Images can become placeholder links (image-1.png, image-2.png… so you can add the files to your repo), be embedded as Base64 data, or be removed.
Limits: it reads .docx only. Old .doc files need to be saved as .docx in Word, LibreOffice or Google Docs first. Headings typed as big bold text rather than with a Heading style come through as bold paragraphs, so apply Heading styles in Word for the best result. Merged table cells, text boxes, comments, tracked changes and page layout have no Markdown equivalent and are dropped; the converter lists the Word styles it couldn't map.
Documentation often starts life in Word, then needs to live in Git, a docs site or a CMS. Retyping it as Markdown is slow and error-prone. A converter that keeps the heading structure, lists and tables gets you a clean first draft in seconds, without uploading a private document to a server.
Something else? Ask the team
Drop the .docx file here, tick Save as README.md, and click Download .md. Add the file to the root of your repository; GitHub shows README.md on the repo's front page.
No. The file is read and converted by JavaScript in your browser. It isn't sent to AI Rank Lab or any other server.
No. Browsers can't read the binary Word 97-2003 format. Open the .doc in Word, LibreOffice or Google Docs, use Save As or Download as .docx, then convert that file.
The converter maps Word's Heading 1–6 styles. If the document uses large bold text instead of Heading styles, select those lines in Word, apply Heading 1, 2 or 3, save and convert again.
By default each image becomes a placeholder link such as , so you can save the images into your repo with those names. You can also embed them as Base64 (large Markdown) or remove them.
Yes. In Google Docs choose File > Download > Microsoft Word (.docx) and convert that file here. Or copy the text and use the Rich Text to Markdown converter.
Each one opens on its own page and works straight away, with no sign-up.
Convert Markdown (.md) to PDF
Paste Google Docs or web text, get Markdown
Remove Markdown formatting from text
Build Markdown tables visually
Explore more free tools:Schema GeneratorMeta Tag GeneratorLLMs.txt GeneratorBrowse all free tools
Word to Markdown Converter (DOCX to MD) is one piece of the puzzle. See how ChatGPT, Gemini, Perplexity, and Google AI Overviews actually view your brand, and get a prioritised list of fixes, with a free AEO & GEO audit from AI Rank Lab.
Run a free AEO & GEO audit or View pricing.
Site audit
Paste your site. The free audit scores it for SEO, answer engines and generative engines, with the fixes.
