How it works
The Word to Markdown converter transforms a .docx file into clean Markdown (.md) syntax — preserving headings, bold, italic, lists, tables, hyperlinks, and inline images. Use it to migrate Word documents into a static site generator, documentation platform (Docusaurus, GitBook, Notion, Confluence), or a Markdown-based knowledge base.
Markdown-based platforms (GitHub, GitLab, Hugo, Jekyll, Obsidian, Notion) accept .md files natively but not .docx. Technical writers who draft documentation in Word for stakeholder review need to convert to Markdown before committing to a docs-as-code repository. This tool automates the conversion in the browser.
How to use it: upload a .docx file. The tool extracts the content and converts it to Markdown syntax. The result is shown in a preview editor. Click Download .md or Copy to Clipboard.
Heading mapping: Word Heading 1 → # H1, Heading 2 → ## H2, etc. Normal text → paragraph. Styled text (bold, italic, underline) is converted to Markdown emphasis.
Table conversion: Word tables are converted to GitHub Flavored Markdown (GFM) table syntax (| col | col | with --- separator rows).
Limitations: complex Word features with no Markdown equivalent (text boxes, tracked changes, comments, drawing objects) are omitted. The converted Markdown is a clean representation of the text content — not a pixel-perfect replica of the Word layout.
Privacy: DOCX parsing runs in the browser.
Frequently Asked Questions
- Heading 1 → # H1, Heading 2 → ## H2, Heading 3 → ### H3, and so on. 'Normal' text → paragraph. List Paragraph → - bullet item or 1. numbered item. If the document uses custom styles, the tool maps them by font size (largest = H1) as a fallback.
- Yes. Text hyperlinks (formatted with the Hyperlink character style) are converted to Markdown [link text](URL) syntax. The visible link text and destination URL are both preserved.
- Embedded images are extracted from the .docx container and saved alongside the .md file (downloaded as a ZIP with the .md and an images/ folder). The Markdown references them as . For the images to display, the images/ folder must be in the same location as the .md file.
- Use the Remove Empty Lines tool on this site to collapse multiple consecutive blank lines to single blank lines. The Word-to-Markdown conversion sometimes introduces extra spacing between elements.