# WordToMD — Word to Markdown Converter

> Free, browser-based tool to convert Microsoft Word (.docx) documents to Markdown format.
> All conversion happens locally in the browser. No file uploads. No registration required.

## About

WordToMD converts Word (.docx) documents to clean Markdown using open-source libraries:
- mammoth.js: reads .docx files, converts to clean HTML
- turndown: converts HTML to Markdown (GFM-compatible)

Privacy guarantee: files are read via the browser FileReader API and never transmitted to any server.

## Pages

- /: Main converter page — upload .docx, get Markdown output instantly
- /about: Tool description, technical details, privacy explanation
- /blog: Guides and tutorials on Word-to-Markdown conversion workflows
- /privacy-policy: Privacy policy (files never leave the user's browser)
- /terms-of-service: Terms of service

## Key Blog Posts

- /blog/how-to-convert-word-to-markdown: Step-by-step conversion guide
- /blog/docx-to-markdown-with-tables: How Word tables become GFM tables

## Supported Conversions

- Headings (H1–H6) → ATX-style Markdown
- Bold (**text**) and italic (_text_)
- Ordered and unordered lists (including nested)
- Tables → GitHub Flavored Markdown tables
- Hyperlinks [text](url)
- Code blocks (fenced)
- Footnotes and endnotes
- Multi-language Unicode content

## Technical Stack

- Framework: Astro 6 (SSR on Cloudflare Workers)
- Styling: Tailwind CSS 4
- Conversion: mammoth.js 1.12 + turndown 7.2
- Deployment: Cloudflare Workers

## Not Supported in V1

- Embedded images (V2 roadmap)
- Merged table cells
- Text boxes and SmartArt
- Track changes (stripped, final content only)