# ConverterToMarkdown

> Free browser-based tool to convert DOCX, PDF, XLSX, XLS, HTML, TXT, MD, CSV, JSON, XML, JPG, PNG, WEBP, BMP and GIF files to Markdown. Includes OCR for scanned PDFs and images. No upload, no server — 100% client-side processing.

## Tool

- [Converter](https://www.convertertomarkdown.com/): Three input modes — single file, URL, or batch (multiple files at once). 15 formats supported, 20 MB max, works offline. Built-in editor with live preview.

## Documentation

- [Full documentation](https://www.convertertomarkdown.com/llms-full.txt): Complete reference for AI systems — all formats, use cases, FAQs, technical details.
- [How it works](https://www.convertertomarkdown.com/como-funciona): Step-by-step guide and library breakdown (mammoth, pdf.js, Tesseract.js, SheetJS, Turndown, PapaParse, marked, JSZip).
- [Use cases](https://www.convertertomarkdown.com/casos-de-uso): Developers, writers, students, data teams, AI/LLM context preparation.

## MCP Server (Model Context Protocol)

- **Package:** `npx convertertomarkdown-mcp`
- **GitHub:** https://github.com/franciscovaleromartin/convertertomarkdown-mcp
- **Compatible with:** Claude Code, Cursor, and any MCP-compatible agent
- **What it does:** Allows AI agents to convert files to Markdown directly without opening a browser
- **Note:** Consumes tokens from the agent. No file upload — processing is local.

## Key Facts

- Converts: DOCX, PDF, XLSX, XLS, HTML, TXT, MD, CSV, JSON, XML, JPG, JPEG, PNG, WEBP, BMP, GIF → Markdown
- OCR: automatic text extraction from scanned PDFs and images via Tesseract.js
- Batch mode: convert multiple files at once, download individually or as a ZIP
- Editor: built-in Markdown editor with live HTML preview and bidirectional sync
- Processing: 100% client-side JavaScript, no server, no upload
- Privacy: files never leave the user's device
- Cost: free, no registration required
- Offline: works after first page load
- Open source: MIT license

## Frequently Asked Questions

**What file formats can be converted to Markdown?**
15 formats: DOCX, PDF, XLSX, XLS, HTML, TXT, MD, CSV, JSON, XML, JPG, PNG, WEBP, BMP and GIF. Images use OCR via Tesseract.js.

**Is it free and does it upload my files?**
Completely free, no registration. Files never leave your browser — all conversion happens client-side with no server upload.

**Is there an MCP server for AI agent integration?**
Yes. Run `npx convertertomarkdown-mcp` to use it from Claude Code, Cursor, or any Model Context Protocol compatible agent.

## Legal

- [Privacy Policy](https://www.convertertomarkdown.com/privacidad): No data collected. Files never leave the browser.
- [License](https://www.convertertomarkdown.com/licencia): MIT License. Free to use, modify and distribute.

## Author

Francisco Valero — Independent Developer
- https://francisco-valero.com
- https://www.linkedin.com/in/francisco-valero/
- https://github.com/franciscovaleromartin