# doc2md-lite

> doc2md-lite is an open-source MCP server for files and documents. Convert text PDFs and HTML pages to Markdown on your own machine, tables intact. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://tidybytetools.github.io/tools/doc2md/
- **Repository:** https://github.com/tidybytetools/doc2md-lite
- **MCP Registry name:** io.github.tidybytetools/doc2md-lite
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

A narrow, offline converter from a small tool maker whose paid sibling handles more formats. This free version takes one text PDF or saved HTML file at a time and writes a Markdown file. PDF headings are guessed from font size and boldness; HTML keeps bold, italic, links and code blocks and drops scripts, styles, menus and footers.

The README is frank about what it skips. Scanned pages are left out and listed, Word files are not read, web pages are not downloaded (save them first), and two-column papers may mix their columns. An option finds tables that have no border lines.

Python 3.10 or newer on Windows, Mac or Linux, MIT licensed. A paid version on Gumroad adds Word files, folders, page ranges and RAG chunks, and an Apify version bills per file. The tool prints a one-line note about the paid version in a terminal; the quiet flag turns it off.

## Features

- **PDF to Markdown:** Text PDFs become Markdown with headings and lists.
- **Real Markdown tables:** Tables are kept as tables, with an option for borderless ones.
- **HTML cleanup:** Navigation, scripts and footers are dropped from saved pages.
- **Runs offline:** Files stay on your computer.
- **Scanned page report:** Image-only pages are skipped and named.

## Good for

- Turn a report PDF into notes-ready Markdown
- Clean a saved web page for an AI app
- Prepare documents before chunking for search
- Extract text and tables from a text PDF for an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add doc2md-lite -- uvx doc2md-lite
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "doc2md-lite": {
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "doc2md-lite": {
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "doc2md-lite": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "doc2md-lite": {
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "doc2md-lite": {
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}
```

## FAQ

### Does it read scanned PDFs?

No. Pages without a text layer are skipped and the tool says which ones.

### Can it convert Word files?

Not the free version; the paid version does.

### Does it upload my files?

No, it runs on your own computer.

### What does the paid version cost?

The site lists $12 on Gumroad, or $0.003 per file on Apify.

### Is doc2md-lite free?

Yes. doc2md-lite is open source, so you can use and self-host it for free.

### How do I add doc2md-lite to Claude Code?

Run this command in your terminal: claude mcp add doc2md-lite -- uvx doc2md-lite

### What are the best alternatives to doc2md-lite?

The closest alternatives to doc2md-lite are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/doc2md-lite
