- Outil
- MarkItDown (Microsoft), uv
- Prix
- Gratuit (licence MIT)
- Temps
- 5 min la 1re fois
- Niveau
- Terminal, débutant
Pourquoi passer par le Markdown ? Parce qu'un assistant IA lit mieux un texte structuré qu'un PDF mis en page : les tableaux restent des tableaux, les titres restent des titres. Et un fichier .md se relit, se corrige et se réutilise dans n'importe quel outil.
Formats pris en charge d'après la documentation : PDF, Word, Excel, PowerPoint, HTML, CSV, JSON, XML, EPUB, archives ZIP, et même des images ou de l'audio (métadonnées, transcription).
Installer MarkItDown
- Installer uvuv installe les outils Python proprement, chacun dans son coin, sans toucher au reste du Mac. Il faut Homebrew.
brew install uv - Installer MarkItDown avec tous les formatsMarkItDown demande Python 3.10 à 3.14 : on précise 3.12 pour éviter une version trop récente.
uv tool install --python 3.12 'markitdown[all]' uv tool update-shell - Fermer et rouvrir le TerminalLa commande
markitdownest alors disponible. Vérifiez avecmarkitdown --help.
Convertir vos documents
- Un seul fichierPlacez-vous dans le dossier du document (
cdpuis glissez le dossier dans le Terminal), puis :markitdown contrat.pdf -o contrat.md - Tout un dossier de PDFUne boucle convertit chaque PDF du dossier et crée un
.mddu même nom. Remplacezpdfpardocxouxlsxpour d'autres formats.for f in *.pdf; do markitdown "$f" -o "${f%.pdf}.md"; done - Donner le résultat à votre assistantJoignez le fichier
.mdà Claude (ou à un autre assistant) avec un prompt précis. Par exemple :Le fichier joint est un document converti en Markdown. 1. Résume-le en 5 points, en citant la section d'où vient chaque point. 2. Liste les dates, montants et engagements, sous forme de tableau. 3. Signale tout passage ambigu ou incomplet. N'invente rien : si une information n'est pas dans le texte, écris « absent du document ».
Ce qu'il faut savoir
- Un PDF scanné est une image : s'il ne contient pas de texte sélectionnable, la conversion sortira vide ou presque.
- La mise en page compliquée (colonnes, tableaux fusionnés) peut sortir en désordre : jetez un œil au
.mdavant de vous en servir. - Pour une seule conversion sans rien installer,
uvx --python 3.12 --from 'markitdown[all]' markitdown fichier.pdffonctionne aussi.
Attention aux données. La conversion reste sur votre Mac, mais dès que vous envoyez le .md à une IA en ligne, il quitte votre ordinateur : retirez ce qui est confidentiel (données clients, coordonnées bancaires). La documentation précise aussi que l'outil lit et écrit avec vos droits : ne l'utilisez que sur des fichiers que vous connaissez, et installez-le uniquement depuis la source officielle.
Sources
Vous recevez chaque semaine des dizaines de PDF à lire et à ressaisir ? La conversion et l'extraction peuvent tourner toutes seules : c'est le genre d'automatisation que je mets en place.