Le dépôt officiel : https://github.com/microsoft/markitdown (licence MIT, 195 354 étoiles au 14 novembre 2026).
CE QU'IL TE FAUT
- Tu vas taper quelques commandes dans le Terminal (Mac) ou dans PowerShell (Windows). Tu peux aussi les coller dans Claude Code et lui demander de les lancer pour toi.
- MarkItDown demande Python 3.10 à 3.14. Pas besoin de l'installer à la main : l'outil uv s'en charge.
- Un PDF scanné (une photo de page) ne contient pas de texte. MarkItDown n'en sortira presque rien sans module de lecture d'image en plus.
Étape 1 : installer uv
uv est le gestionnaire qui installe MarkItDown et le Python qu'il lui faut.
Sur Mac, ouvre le Terminal et colle :
curl -LsSf https://astral.sh/uv/install.sh | shSur Windows, ouvre PowerShell et colle :
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Ferme la fenêtre et rouvre-la pour que la commande uv soit reconnue.
Étape 2 : convertir un premier fichier
Sans autre installation, cette commande télécharge MarkItDown, convertit ton PDF et crée document.md dans le même dossier :
uvx --from 'markitdown[all]' markitdown contrat.pdf -o document.mdRemplace contrat.pdf par le nom de ton fichier. Pour l'avoir en permanence et taper seulement markitdown contrat.pdf -o document.md, installe-le une fois pour toutes (à tester) :
uv tool install 'markitdown[all]'Tu préfères pip et tu as déjà Python ? La commande officielle est pip install 'markitdown[all]'.
Ensuite, glisse le fichier .md dans Claude à la place du PDF.
Étape 3 : brancher le serveur MCP sur Claude Desktop
Le serveur officiel s'appelle markitdown-mcp (même dépôt, dossier packages/markitdown-mcp). Il donne à Claude un seul outil, convert_to_markdown, qui lit un fichier de ton ordinateur ou une page web.
Dans Claude Desktop : menu Claude en haut de l'écran, puis « Settings… », onglet « Developer », bouton « Edit Config ». Le fichier qui s'ouvre est :
- Mac :
~/Library/Application Support/Claude/claude_desktop_config.json - Windows :
%APPDATA%\Claude\claude_desktop_config.json
Colle ce bloc (à tester, la doc Microsoft recommande Docker, voir plus bas) :
{
"mcpServers": {
"markitdown": {
"command": "uvx",
"args": ["markitdown-mcp"]
}
}
}Si ton fichier contient déjà d'autres serveurs, ajoute seulement le bloc "markitdown" à l'intérieur de "mcpServers". Quitte Claude Desktop complètement et relance-le.
Si le serveur ne se connecte pas, Claude Desktop ne trouve pas uvx. Tape which uvx dans le Terminal (where uvx sous Windows) et remplace "uvx" par le chemin complet qui s'affiche.
La méthode officielle passe par Docker : docker build -t markitdown-mcp:latest . depuis le dossier packages/markitdown-mcp, puis "command": "docker" et "args": ["run", "--rm", "-i", "markitdown-mcp:latest"]. Plus lourd si tu n'as jamais utilisé Docker.
Étape 4 : brancher le serveur MCP sur Claude Code
Dans le Terminal, une seule ligne (à tester) :
claude mcp add markitdown --scope user -- uvx markitdown-mcp--scope user le rend disponible dans tous tes projets. Tape ensuite /mcp dans Claude Code pour vérifier qu'il est connecté.
Le prompt pour t'en servir
Avec l'outil markitdown, convertis le fichier file:///Users/[ton nom]/Documents/[fichier].pdf en Markdown, puis résume-le en 10 points et liste les chiffres qu'il contient.
L'outil attend une adresse qui commence par file:// pour un fichier de ton ordinateur, ou https:// pour une page web. Sous Windows : file:///C:/Users/[ton nom]/Documents/[fichier].pdf (à tester).
Les formats pris en charge
D'après le dépôt officiel : PDF, PowerPoint, Word, Excel, images (métadonnées et description), audio (métadonnées et transcription), HTML, CSV, JSON, XML, ZIP (il ouvre chaque fichier), liens YouTube, EPub. La description d'image et la transcription audio passent par des services en ligne.
Sans rien installer
Il n'existe pas de version en ligne officielle de Microsoft. Des sites non officiels font tourner MarkItDown dans le navigateur, par exemple any2markdown.pages.dev (à tester). N'y envoie jamais un contrat, un bilan ou un document client : tu ne sais pas où il part.
Ce qu'il faut savoir sur la sécurité
Le serveur MCP n'a pas de mot de passe et lit tout ce que ton compte peut lire. Microsoft le prévoit pour un usage local uniquement : ne le lance pas en mode réseau (--http) sur autre chose que 127.0.0.1.
