Frequently Asked Questions

Everything you need to know about MDTools and our free Markdown conversion tools.

General Questions

Is the Markdown to Word converter completely free?

Yes, MDTools is 100% free with no hidden charges. There are no subscription fees, no premium tiers, and no per-conversion limits. You can convert as many Markdown files as you need, as often as you want, forever.

Is it safe to use — are my files uploaded to a server?

Your files are never uploaded anywhere. All conversion happens entirely in your web browser using JavaScript. Your Markdown content, Word documents, and Excel files stay on your device at all times. We cannot see, access, or store any of your document content. This is not a policy — it is an architectural guarantee.

Does it work on mobile and tablet?

Yes. MDTools is fully responsive and works on smartphones and tablets. The converter layout adapts to smaller screens. However, for complex Markdown documents with many tables and code blocks, a desktop browser provides the best editing experience.

What browsers are supported?

MDTools works in all modern browsers: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+, and Opera. Internet Explorer is not supported. For the best experience, use the latest version of Chrome or Edge.

Does it work offline?

The page itself requires an internet connection to load (to download the JavaScript libraries from CDNs). Once the page has fully loaded, the conversion tools work without any further network requests — your document content never leaves your device even when online.

Is there a dark mode?

Yes. Click the sun/moon icon in the top navigation bar to toggle between light and dark mode. Your preference is saved in your browser's local storage and persists across visits.

Markdown to Word

What Markdown syntax is supported?

We support the full CommonMark specification plus GitHub Flavored Markdown (GFM) extensions: headings (H1–H6), bold, italic, strikethrough, inline code, fenced code blocks, blockquotes, ordered and unordered lists, nested lists, task lists, links, images, horizontal rules, and GitHub-style pipe tables.

Is there a file size limit?

For file uploads, we support .md files up to 10MB. For typed or pasted content, there is no practical size limit since everything processes locally in your browser.

What word processors can open the DOCX output?

The generated DOCX is compatible with Microsoft Word (2016 and later), Google Docs, LibreOffice Writer, WPS Office, Apple Pages (via import), and any application that supports the Open XML (.docx) format.

Can I convert multiple Markdown files at once?

Currently, the converter processes one document at a time. You can paste content from multiple files into the editor to combine them, or convert each file separately.

What is the difference between DOCX and DOC format?

DOC is the older binary format from Word 97–2003. DOCX is the modern Open XML format (Word 2007+), which is smaller, more compatible with non-Microsoft software, and the recommended format for all new documents. Our converter outputs DOCX.

Does it support tables and code blocks?

Yes. GitHub-style pipe tables convert to native Word table objects with styled header rows. Fenced code blocks render with monospace font and background shading in the DOCX output.

Can I convert a GitHub README.md to Word?

Yes. Copy the raw content of any GitHub README.md (click the "Raw" button on GitHub), paste it into the editor, and click Download. All headings, lists, code blocks, and tables are preserved.

How long does conversion take?

Conversion is nearly instantaneous for documents under 100KB. Larger documents with many tables or deeply nested structures may take 1–3 seconds. PDF conversion takes slightly longer due to the image-capture rendering approach.

Can I use the converted documents commercially?

Yes. MDTools places no restrictions on the documents you create using our tools. The output files are yours to use for any purpose, including commercial use. We claim no rights over your converted documents.

Does it support Math formulas and Mermaid charts?

Math formulas (LaTeX/KaTeX syntax) and Mermaid diagram syntax are not currently rendered in the DOCX output — they will appear as plain text. This is a planned future feature.

Markdown to PDF

What paper size does the PDF use?

The PDF is generated in A4 format (210mm × 297mm) with 10mm margins, which is the international standard for professional documents. Letter size (US) support is planned for a future release.

Does it support multi-page PDFs?

Yes. Long documents automatically span multiple PDF pages. The converter renders your Markdown to HTML, captures it at high resolution, then splits the content across pages as needed.

Word to Markdown

Does it support .doc (old Word format) files?

Only .docx (Open XML) format is supported. If you have a .doc file, open it in Word or LibreOffice and save it as .docx first, then upload it here.

What happens to images embedded in the Word document?

Embedded images are not currently extracted to the Markdown output. Text content, headings, lists, tables, and text formatting are converted; images are skipped. This is a browser security limitation of the FileReader API.

HTML & Excel Tools

Can I convert HTML to Markdown?

Yes — use our HTML to Markdown converter. Paste any HTML and get clean Markdown output instantly. All standard HTML elements (headings, lists, links, tables, code blocks) are supported.

How do I convert a Markdown table to Excel?

Use our Markdown Table to Excel converter. Paste your GitHub-style Markdown table and click "Convert & Download .xlsx". The Excel file opens in Microsoft Excel, Google Sheets, or LibreOffice Calc.

Still have a question?

Can't find your answer here? Contact us and we'll reply within 24 hours.

Contact Us →